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.
31 lines (29 loc) • 1.42 kB
HTML
<html>
<head>
<meta charset="UTF-8">
<title>Macros 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>Macros Import</h1>
<div class="topic-meta">Topic: <code>macros_import</code></div>
<h2>Explanation</h2>
<p><code>@macros_import "file.pml"</code> loads a generated or hand-written ProtoML file that contains <code>@macro ...</code> declarations.</p>
<p>This is mainly intended for project-local external macro pack workflows. After <code>protoparser macro_install sync</code>, a generated import file is written to:</p>
<p><code>.protoml/macro-packs/macros.index.pml</code></p>
<p>Use it in a document like this:</p>
<p><code>@macros_import ".protoml/macro-packs/macros.index.pml"</code></p>
<p>The imported file is read before normal macro loading. Its macro declarations are merged into the current document. Local <code>@macro ...</code> declarations in the document still win over imported ones with the same name.</p>
<h2>Examples</h2>
<pre><code>@macros_import ".protoml/macro-packs/macros.index.pml"
@meeting "Macro Demo"
@@macro=contract-kit_sample:title=Demo;text=Loaded through the generated macro index</code></pre>
</main>
</body>
</html>