From: Fletcher T. Penney Date: Sat, 23 Sep 2017 16:46:14 +0000 (-0400) Subject: UPDATED: Update QuickStart Guide X-Git-Tag: 6.2.2^2~3 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=da9caca538034249595833bb5b66b2eb6eefc54b;p=multimarkdown UPDATED: Update QuickStart Guide --- diff --git a/QuickStart/QuickStart.epub b/QuickStart/QuickStart.epub index fb633a6..0939ce3 100644 Binary files a/QuickStart/QuickStart.epub and b/QuickStart/QuickStart.epub differ diff --git a/QuickStart/QuickStart.fodt b/QuickStart/QuickStart.fodt index 666eabc..3aa98f8 100644 --- a/QuickStart/QuickStart.fodt +++ b/QuickStart/QuickStart.fodt @@ -296,6 +296,7 @@ office:mimetype="application/vnd.oasis.opendocument.text"> Abbreviations (Or Acronyms) 1 Citations 1 CriticMarkup 1 +Embedded Images 1 Emph and Strong 1 EPUB 3 Support 1 Fenced Code Blocks 1 @@ -306,7 +307,7 @@ office:mimetype="application/vnd.oasis.opendocument.text"> LaTeX Changes 1 Metadata 1 Output Formats 1 -Embedded Images 1 +Raw Source 1 Table of Contents 1 Tables 1 Transclusion 1 @@ -489,7 +490,28 @@ formatting to the CriticMarkup formatting as in the preceding paragraph. Alternatively, you can use the -a\--accept or -r\--reject options to cause MMD to accept or reject, respectively, the proposed changes within the CM markup. When doing this, CM will work across blank lines. Without either of -these two options, then CriticMarkup that spans a blank line is not recognized +these two options, then CriticMarkup that spans a blank line is not recogniz + +T +formats). + +Embedded Images + +Supported export formats (odt, epub, bundle, bundlezip) include +images inside the export document: + + + + +Local images are embedded automatically + + +Images stored on remote servers are embedded if libCurl is +properly installed when MMD is compiled. This is true f + + + +ed as such. I working on options for this for the future. Emph and Strong @@ -743,24 +765,41 @@ and images between applications (on any OS, but especially on iOS) bundlezip – TextPack variant of the TextBundle format – the file -package is compressed to a single zip file (similar to EPUB and ODT -formats). +package is compressed to a single zip file (similar to EPUB and ODor macOS builds. -Embedded Images +Raw Source -Supported export formats (odt, epub, bundle, bundlezip) include -images inside the export document: +In older versions of MultiMarkdown you could use an HTML comment to pass raw LaTeX or other content to the final document. This worked reasonably well, but was limited and didn’t work well when exporting to multiple formats. It was time for something new. + +MMD v6 offers a new feature to handle this. Code spans and code blocks can be flagged as representing raw source: + +foo `*bar*`{=html}```{=latex}*foo*``` + +The contents of the span/block will be passed through unchanged. + +You can specify which output format is compatible with the specified source: -Local images are embedded automatically +html -Images stored on remote servers are embedded if libCurl is -properly installed when MMD is compiled. This is true for macOS builds. + +odt + + + +epub + + + +latex + + +* – wildcard matches any output format diff --git a/QuickStart/QuickStart.html b/QuickStart/QuickStart.html index ddb97ed..33ebd61 100644 --- a/QuickStart/QuickStart.html +++ b/QuickStart/QuickStart.html @@ -20,6 +20,7 @@
  • Abbreviations (Or Acronyms)
  • Citations
  • CriticMarkup
    • +
  • Embedded Images
  • Emph and Strong
  • EPUB 3 Support
  • Fenced Code Blocks
    • @@ -30,7 +31,7 @@
  • LaTeX Changes
  • Metadata
  • Output Formats
    • -
  • Embedded Images
    • +
  • Raw Source
  • Table of Contents
  • Tables
  • Transclusion
    • @@ -201,7 +202,23 @@ formatting to the CriticMarkup formatting as in the preceding paragraph. Alternatively, you can use the -a\--accept or -r\--reject options to cause MMD to accept or reject, respectively, the proposed changes within the CM markup. When doing this, CM will work across blank lines. Without either of -these two options, then CriticMarkup that spans a blank line is not recognized +these two options, then CriticMarkup that spans a blank line is not recogniz

    + +

    T +formats).

    + +

    Embedded Images

    + +

    Supported export formats (odt, epub, bundle, bundlezip) include +images inside the export document:

    + + + +

    ed as such. I working on options for this for the future.

    Emph and Strong

    @@ -416,19 +433,32 @@ file package. text file and embedded images and CSS. Useful for sharing Markdown files and images between applications (on any OS, but especially on iOS)
  • bundlezip – TextPack variant of the TextBundle format – the file -package is compressed to a single zip file (similar to EPUB and ODT -formats).
    • +package is compressed to a single zip file (similar to EPUB and ODor macOS builds. -

    Embedded Images

    +

    Raw Source

    -

    Supported export formats (odt, epub, bundle, bundlezip) include -images inside the export document:

    +

    In older versions of MultiMarkdown you could use an HTML comment to pass raw LaTeX or other content to the final document. This worked reasonably well, but was limited and didn’t work well when exporting to multiple formats. It was time for something new.

    + +

    MMD v6 offers a new feature to handle this. Code spans and code blocks can be flagged as representing raw source:

    + +
    foo `*bar*`{=html}
+
+```{=latex}
+*foo*
+```
+
    + +

    The contents of the span/block will be passed through unchanged.

    + +

    You can specify which output format is compatible with the specified source:

    Table of Contents

    diff --git a/QuickStart/QuickStart.pdf b/QuickStart/QuickStart.pdf index 7364142..8339edb 100644 Binary files a/QuickStart/QuickStart.pdf and b/QuickStart/QuickStart.pdf differ diff --git a/QuickStart/QuickStart.txt b/QuickStart/QuickStart.txt index 09ea54f..ee532fa 100644 --- a/QuickStart/QuickStart.txt +++ b/QuickStart/QuickStart.txt @@ -177,7 +177,24 @@ formatting to the CriticMarkup formatting as in the preceding paragraph. Alternatively, you can use the `-a\--accept` or `-r\--reject` options to cause MMD to accept or reject, respectively, the proposed changes within the CM markup. When doing this, CM will work across blank lines. Without either of -these two options, then CriticMarkup that spans a blank line is not recognized +these two options, then CriticMarkup that spans a blank line is not recogniz + +T +formats). + +[LaTeX]: https://en.wikipedia.org/wiki/LaTeX + + +## Embedded Images ## + +Supported export formats (`odt`, `epub`, `bundle`, `bundlezip`) include +images inside the export document: + +* Local images are embedded automatically +* Images stored on remote servers are embedded *if* [libCurl] is +properly installed when MMD is compiled. This is true f + +ed as such. I working on options for this for the future. @@ -392,22 +409,32 @@ file package. text file and embedded images and CSS. Useful for sharing Markdown files and images between applications (on any OS, but especially on iOS) * `bundlezip` -- TextPack variant of the TextBundle format -- the file -package is compressed to a single zip file (similar to EPUB and ODT -formats). +package is compressed to a single zip file (similar to EPUB and ODor macOS builds. -[LaTeX]: https://en.wikipedia.org/wiki/LaTeX +[libCurl]: https://curl.haxx.se/libcurl/ -## Embedded Images ## +## Raw Source ## -Supported export formats (`odt`, `epub`, `bundle`, `bundlezip`) include -images inside the export document: +In older versions of MultiMarkdown you could use an HTML comment to pass raw LaTeX or other content to the final document. This worked reasonably well, but was limited and didn't work well when exporting to multiple formats. It was time for something new. -* Local images are embedded automatically -* Images stored on remote servers are embedded *if* [libCurl] is -properly installed when MMD is compiled. This is true for macOS builds. +MMD v6 offers a new feature to handle this. Code spans and code blocks can be flagged as representing raw source: -[libCurl]: https://curl.haxx.se/libcurl/ + foo `*bar*`{=html} + + ```{=latex} + *foo* + ``` + +The contents of the span/block will be passed through unchanged. + +You can specify which output format is compatible with the specified source: + +* `html` +* `odt` +* `epub` +* `latex` +* `*` -- wildcard matches any output format ## Table of Contents ##