From: Fletcher T. Penney Date: Tue, 15 Aug 2017 17:16:31 +0000 (-0400) Subject: UPDATED: Update quick start guide X-Git-Tag: 6.2.0^2~1 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=b3ad17aa07a7ef2d5d5d63b21468dd3d1da49d43;p=multimarkdown UPDATED: Update quick start guide --- diff --git a/QuickStart/QuickStart.epub b/QuickStart/QuickStart.epub index 5b1c2a0..62da426 100644 Binary files a/QuickStart/QuickStart.epub and b/QuickStart/QuickStart.epub differ diff --git a/QuickStart/QuickStart.fodt b/QuickStart/QuickStart.fodt index 34365f3..be49d1e 100644 --- a/QuickStart/QuickStart.fodt +++ b/QuickStart/QuickStart.fodt @@ -1,39 +1,41 @@ +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"> MultiMarkdown v6 Quick Start Guide - Fletcher T. Penney + Fletcher T. Penney 6.1.0 0d6313fa-9135-477e-9c14-7d62c1977833 @@ -691,6 +693,13 @@ options are dutch, +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 TitleMMD Header:This is *MMD* text.MMD Footer:{{footer.txt}} + Output Formats MultiMarkdown 6 supports the following output formats, using the -t @@ -777,47 +786,47 @@ path for included files. For example: - Directory + Directory - Transcluded Filename + Transcluded Filename - Resolved Path + Resolved Path - /foo/bar/ + /foo/bar/ - bat + bat - /foo/bar/bat + /foo/bar/bat - /foo/bar/ + /foo/bar/ - baz/bat + baz/bat - /foo/bar/baz/bat + /foo/bar/baz/bat - /foo/bar/ + /foo/bar/ - ../bat + ../bat - /foo/bat + /foo/bat @@ -862,4 +871,4 @@ and “stuff between headers”. - \ No newline at end of file + diff --git a/QuickStart/QuickStart.html b/QuickStart/QuickStart.html index 8be9540..9be0419 100644 --- a/QuickStart/QuickStart.html +++ b/QuickStart/QuickStart.html @@ -381,6 +381,16 @@ options are dutch, french, german, 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

MultiMarkdown 6 supports the following output formats, using the -t @@ -445,27 +455,27 @@ path for included files. For example:

- Directory - Transcluded Filename - Resolved Path + Directory + Transcluded Filename + Resolved Path - /foo/bar/ - bat - /foo/bar/bat + /foo/bar/ + bat + /foo/bar/bat - /foo/bar/ - baz/bat - /foo/bar/baz/bat + /foo/bar/ + baz/bat + /foo/bar/baz/bat - /foo/bar/ - ../bat - /foo/bat + /foo/bar/ + ../bat + /foo/bat @@ -530,3 +540,4 @@ glossary collects information about important terms used in your document + diff --git a/QuickStart/QuickStart.pdf b/QuickStart/QuickStart.pdf index fa044fe..33f0790 100644 Binary files a/QuickStart/QuickStart.pdf and b/QuickStart/QuickStart.pdf differ diff --git a/QuickStart/QuickStart.txt b/QuickStart/QuickStart.txt index d9602f0..8047dd7 100644 --- a/QuickStart/QuickStart.txt +++ b/QuickStart/QuickStart.txt @@ -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