mirror of
https://github.com/fletcher/MultiMarkdown-6.git
synced 2024-10-04 02:27:10 +03:00
UPDATED: Update quick start guide
This commit is contained in:
Fletcher T. Penney
parent
4423bf1d97
commit
b3ad17aa07
Binary file not shown.
@ -1,39 +1,41 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<office:document xmlns:office="urn:oasis:names:tc:opendocument:xmlns:office:1.0"
|
||||
xmlns:style="urn:oasis:names:tc:opendocument:xmlns:style:1.0"
|
||||
xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0"
|
||||
xmlns:table="urn:oasis:names:tc:opendocument:xmlns:table:1.0"
|
||||
xmlns:draw="urn:oasis:names:tc:opendocument:xmlns:drawing:1.0"
|
||||
xmlns:fo="urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
xmlns:dc="http://purl.org/dc/elements/1.1/"
|
||||
xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0"
|
||||
xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0"
|
||||
xmlns:svg="urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0"
|
||||
xmlns:chart="urn:oasis:names:tc:opendocument:xmlns:chart:1.0"
|
||||
xmlns:dr3d="urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0"
|
||||
xmlns:math="http://www.w3.org/1998/Math/MathML"
|
||||
xmlns:form="urn:oasis:names:tc:opendocument:xmlns:form:1.0"
|
||||
xmlns:script="urn:oasis:names:tc:opendocument:xmlns:script:1.0"
|
||||
xmlns:config="urn:oasis:names:tc:opendocument:xmlns:config:1.0"
|
||||
xmlns:ooo="http://openoffice.org/2004/office"
|
||||
xmlns:ooow="http://openoffice.org/2004/writer"
|
||||
xmlns:oooc="http://openoffice.org/2004/calc"
|
||||
xmlns:dom="http://www.w3.org/2001/xml-events"
|
||||
xmlns:xforms="http://www.w3.org/2002/xforms"
|
||||
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:rpt="http://openoffice.org/2005/report"
|
||||
xmlns:of="urn:oasis:names:tc:opendocument:xmlns:of:1.2"
|
||||
xmlns:xhtml="http://www.w3.org/1999/xhtml"
|
||||
xmlns:grddl="http://www.w3.org/2003/g/data-view#"
|
||||
xmlns:tableooo="http://openoffice.org/2009/table"
|
||||
xmlns:field="urn:openoffice:names:experimental:ooo-ms-interop:xmlns:field:1.0"
|
||||
xmlns:formx="urn:openoffice:names:experimental:ooxml-odf-interop:xmlns:form:1.0"
|
||||
xmlns:css3t="http://www.w3.org/TR/css3-text/"
|
||||
office:version="1.2"
|
||||
grddl:transformation="http://docs.oasis-open.org/office/1.2/xslt/odf2rdf.xsl"
|
||||
office:mimetype="application/vnd.oasis.opendocument.text">
|
||||
xmlns:style="urn:oasis:names:tc:opendocument:xmlns:style:1.0"
|
||||
xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0"
|
||||
xmlns:table="urn:oasis:names:tc:opendocument:xmlns:table:1.0"
|
||||
xmlns:draw="urn:oasis:names:tc:opendocument:xmlns:drawing:1.0"
|
||||
xmlns:fo="urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
xmlns:dc="http://purl.org/dc/elements/1.1/"
|
||||
xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0"
|
||||
xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0"
|
||||
xmlns:svg="urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0"
|
||||
xmlns:chart="urn:oasis:names:tc:opendocument:xmlns:chart:1.0"
|
||||
xmlns:dr3d="urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0"
|
||||
xmlns:math="http://www.w3.org/1998/Math/MathML"
|
||||
xmlns:form="urn:oasis:names:tc:opendocument:xmlns:form:1.0"
|
||||
xmlns:script="urn:oasis:names:tc:opendocument:xmlns:script:1.0"
|
||||
xmlns:ooo="http://openoffice.org/2004/office"
|
||||
xmlns:ooow="http://openoffice.org/2004/writer"
|
||||
xmlns:oooc="http://openoffice.org/2004/calc"
|
||||
xmlns:dom="http://www.w3.org/2001/xml-events"
|
||||
xmlns:xforms="http://www.w3.org/2002/xforms"
|
||||
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:rpt="http://openoffice.org/2005/report"
|
||||
xmlns:of="urn:oasis:names:tc:opendocument:xmlns:of:1.2"
|
||||
xmlns:xhtml="http://www.w3.org/1999/xhtml"
|
||||
xmlns:grddl="http://www.w3.org/2003/g/data-view#"
|
||||
xmlns:officeooo="http://openoffice.org/2009/office"
|
||||
xmlns:tableooo="http://openoffice.org/2009/table"
|
||||
xmlns:drawooo="http://openoffice.org/2010/draw"
|
||||
xmlns:calcext="urn:org:documentfoundation:names:experimental:calc:xmlns:calcext:1.0"
|
||||
xmlns:loext="urn:org:documentfoundation:names:experimental:office:xmlns:loext:1.0"
|
||||
xmlns:field="urn:openoffice:names:experimental:ooo-ms-interop:xmlns:field:1.0"
|
||||
xmlns:formx="urn:openoffice:names:experimental:ooxml-odf-interop:xmlns:form:1.0"
|
||||
xmlns:css3t="http://www.w3.org/TR/css3-text/"
|
||||
office:version="1.2"
|
||||
office:mimetype="application/vnd.oasis.opendocument.text">
|
||||
<office:font-face-decls>
|
||||
<style:font-face style:name="Courier New" svg:font-family="'Courier New'"
|
||||
style:font-adornments="Regular"
|
||||
@ -273,7 +275,7 @@
|
||||
</office:master-styles>
|
||||
<office:meta>
|
||||
<dc:title>MultiMarkdown v6 Quick Start Guide</dc:title>
|
||||
<meta:user-defined meta:name="author">Fletcher T. Penney</meta:user-defined>
|
||||
<dc:creator>Fletcher T. Penney</dc:creator>
|
||||
<meta:user-defined meta:name="version">6.1.0</meta:user-defined>
|
||||
<meta:user-defined meta:name="uuid">0d6313fa-9135-477e-9c14-7d62c1977833</meta:user-defined>
|
||||
</office:meta>
|
||||
@ -691,6 +693,13 @@ options are <text:span text:style-name="Source_20_Text">dutch</text:span>, <text
|
||||
|
||||
</text:list>
|
||||
|
||||
<text:p text:style-name="Standard">Additionally, the <text:span text:style-name="Source_20_Text">MMD Header</text:span> and <text:span text:style-name="Source_20_Text">MMD Footer</text:span> metadata work slightly differently. In
|
||||
v5, these fields were used to list names of files that should be transcluded before and after
|
||||
the main body. In v6, these fields represent the actual text to be inserted. If you want them
|
||||
to reference separate files, use the transclusion functionality:</text:p>
|
||||
|
||||
<text:p text:style-name="Preformatted Text">Title:<text:tab/>Some Title<text:line-break/>MMD Header:<text:tab/>This is *MMD* text.<text:line-break/>MMD Footer:<text:tab/>{{footer.txt}}<text:line-break/></text:p>
|
||||
|
||||
<text:h text:outline-level="4"><text:bookmark text:name="outputformats"/>Output Formats </text:h>
|
||||
|
||||
<text:p text:style-name="Standard">MultiMarkdown 6 supports the following output formats, using the <text:span text:style-name="Source_20_Text">-t</text:span>
|
||||
@ -777,47 +786,47 @@ path for included files. For example:</text:p>
|
||||
|
||||
<table:table-row>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="Table_20_Heading"> Directory </text:p>
|
||||
<text:p text:style-name="Table_20_Heading"> Directory<text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="Table_20_Heading"> Transcluded Filename </text:p>
|
||||
<text:p text:style-name="Table_20_Heading"> Transcluded Filename<text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="Table_20_Heading"> Resolved Path </text:p>
|
||||
<text:p text:style-name="Table_20_Heading"> Resolved Path <text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
</table:table-row>
|
||||
|
||||
<table:table-row>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">bat</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">bat</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/bat</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/bat</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
</table:table-row>
|
||||
<table:table-row>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">baz/bat</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">baz/bat</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/baz/bat</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/baz/bat</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
</table:table-row>
|
||||
<table:table-row>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bar/</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">../bat</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">../bat</text:span> <text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
<table:table-cell>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bat</text:span> </text:p>
|
||||
<text:p text:style-name="MMD-Table"> <text:span text:style-name="Source_20_Text">/foo/bat</text:span><text:tab/></text:p>
|
||||
</table:table-cell>
|
||||
</table:table-row>
|
||||
|
||||
@ -862,4 +871,4 @@ and “stuff between headers”.</text:p></text:list-item>
|
||||
</text:list>
|
||||
</office:text>
|
||||
</office:body>
|
||||
</office:document>
|
||||
</office:document>
|
||||
|
||||
@ -381,6 +381,16 @@ options are <code>dutch</code>, <code>french</code>, <code>german</code>, <code>
|
||||
<code>fr</code>, <code>de</code>, <code>sv</code>. Anything else defaults to English.</p></li>
|
||||
</ul>
|
||||
|
||||
<p>Additionally, the <code>MMD Header</code> and <code>MMD Footer</code> metadata work slightly differently. In
|
||||
v5, these fields were used to list names of files that should be transcluded before and after
|
||||
the main body. In v6, these fields represent the actual text to be inserted. If you want them
|
||||
to reference separate files, use the transclusion functionality:</p>
|
||||
|
||||
<pre><code>Title: Some Title
|
||||
MMD Header: This is *MMD* text.
|
||||
MMD Footer: {{footer.txt}}
|
||||
</code></pre>
|
||||
|
||||
<h4 id="outputformats">Output Formats </h4>
|
||||
|
||||
<p>MultiMarkdown 6 supports the following output formats, using the <code>-t</code>
|
||||
@ -445,27 +455,27 @@ path for included files. For example:</p>
|
||||
|
||||
<thead>
|
||||
<tr>
|
||||
<th> Directory </th>
|
||||
<th> Transcluded Filename </th>
|
||||
<th> Resolved Path </th>
|
||||
<th> Directory </th>
|
||||
<th> Transcluded Filename </th>
|
||||
<th> Resolved Path </th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<tr>
|
||||
<td> <code>/foo/bar/</code> </td>
|
||||
<td> <code>bat</code> </td>
|
||||
<td> <code>/foo/bar/bat</code> </td>
|
||||
<td> <code>/foo/bar/</code> </td>
|
||||
<td> <code>bat</code> </td>
|
||||
<td> <code>/foo/bar/bat</code> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td> <code>/foo/bar/</code> </td>
|
||||
<td> <code>baz/bat</code> </td>
|
||||
<td> <code>/foo/bar/baz/bat</code> </td>
|
||||
<td> <code>/foo/bar/</code> </td>
|
||||
<td> <code>baz/bat</code> </td>
|
||||
<td> <code>/foo/bar/baz/bat</code> </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td> <code>/foo/bar/</code> </td>
|
||||
<td> <code>../bat</code> </td>
|
||||
<td> <code>/foo/bat</code> </td>
|
||||
<td> <code>/foo/bar/</code> </td>
|
||||
<td> <code>../bat</code> </td>
|
||||
<td> <code>/foo/bat</code> </td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -530,3 +540,4 @@ glossary collects information about important terms used in your document <a hre
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
||||
|
||||
Binary file not shown.
@ -359,6 +359,15 @@ will also set the default `quotes language`.
|
||||
options are `dutch`, `french`, `german`, `germanguillemets`, `swedish`, `nl`,
|
||||
`fr`, `de`, `sv`. Anything else defaults to English.
|
||||
|
||||
Additionally, the `MMD Header` and `MMD Footer` metadata work slightly differently. In
|
||||
v5, these fields were used to list names of files that should be transcluded before and after
|
||||
the main body. In v6, these fields represent the actual text to be inserted. If you want them
|
||||
to reference separate files, use the transclusion functionality:
|
||||
|
||||
Title: Some Title
|
||||
MMD Header: This is *MMD* text.
|
||||
MMD Footer: {{footer.txt}}
|
||||
|
||||
|
||||
## Output Formats ##
|
||||
|
||||
@ -418,12 +427,11 @@ handled is more flexible, though it may take a moment to understand.
|
||||
When you process a file with MMD, it uses that file's directory as the search
|
||||
path for included files. For example:
|
||||
|
||||
| Directory | Transcluded Filename | Resolved Path |
|
||||
| ----------- | -------------------- | ------------------ |
|
||||
| `/foo/bar/` | `bat` | `/foo/bar/bat` |
|
||||
| `/foo/bar/` | `baz/bat` | `/foo/bar/baz/bat` |
|
||||
| `/foo/bar/` | `../bat` | `/foo/bat` |
|
||||
|
||||
| Directory | Transcluded Filename | Resolved Path |
|
||||
| ------------------ | ----------------------------- | ------------------------------ |
|
||||
| `/foo/bar/` | `bat` | `/foo/bar/bat` |
|
||||
| `/foo/bar/` | `baz/bat` | `/foo/bar/baz/bat` |
|
||||
| `/foo/bar/` | `../bat` | `/foo/bat` |
|
||||
|
||||
This is the same as MMD v 5. What's different is that when you transclude a
|
||||
file, the search path stays the same as the "parent" file, **UNLESS** you use
|
||||
|
||||
Loading…
Reference in New Issue
Block a user