protoml-parser
Version:
ProtoML is a lightweight, declarative markup language designed for writing and structuring meeting protocols, notes and task lists in a human-readable and machine-parseable format.
50 lines (44 loc) • 1.8 kB
HTML
<html>
<head>
<meta charset="UTF-8">
<title>Participants Import - ProtoML 1.4.2+build67</title>
<link rel="stylesheet" href="help.css">
</head>
<body>
<nav class="topnav">
<a href="../toc.html">Contents</a>
<span class="version">ProtoML 1.4.2+build67</span>
</nav>
<main class="page">
<h1>Participants Import</h1>
<div class="topic-meta">Topic: <code>participants_import</code></div>
<h2>Explanation</h2>
<p>The <code>@participants_import</code> command includes an external <code>.pml</code> participant definition file into the current ProtoML document.</p>
<p>Participants imported this way can be reused in task assignments via <code>@ptp=id</code> and in references such as <code>@@ref=participants:id:name</code>.</p>
<p>The external file should start with <code>@participants</code> and contain <code>=id:Name[,alias,email]</code> entries.</p>
<p>Typical workflow:</p>
<ul>
<li>create a shared <code>participants.pml</code> file with an <code>@participants</code> block</li>
<li>import that file into the meeting document with <code>@participants_import "..."</code></li>
<li>reuse the imported IDs in tasks, <code>@@e=...</code>, and <code>@@ref=participants:...</code></li>
</ul>
<p>The import path should be wrapped in double quotes.</p>
<h2>Examples</h2>
<pre><code>Shared file `participants.pml`:
@participants
=lead:Jane Doe,jdoe,jdoe@example.com
=ops:Max Mustermann,mmustermann,max@example.com
Main meeting file:
@participants_import "participants.pml"
@protocol "Weekly Sync - {{date}}"
@tasks
-[ ] Prepare release notes @ptp=lead
-[ ] Check deployment logs @ptp=ops
@meeting "Minutes"
# Weekly Sync
Responsible: @@e=lead
Lead mail: @@ref=participants:lead:email</code></pre>
</main>
</body>
</html>