Marked 2 for Mac的使用技巧

今天为大家介绍一款实用的文本编辑工具“Marked 2 for Mac”，适用于所有类型编写器的工具集合，并监视您的文档以进行更改，并在保存文件时更新预览。凭借全套自定义选项和预览样式，Marked 2 for Mac为任何文本编辑器添加了理想的“实时”Markdown预览，并为您的编写工作流程添加了一套功能强大的工具。

1.确保您没有使用rubymacOS默认使用的，但是使用Homebrew安装的那个。如果需要，brew link --overwrite ruby让每个人都在同一条线上。这意味着，rbenv暂时摆脱然后安装asciidoctor。

2.asciidoctor以root（sudo gem install asciidoctor）方式安装和相关的gem 。

3.使用首选项>高级>启用自定义处理器选项配置标记2：

• 路径： /usr/local/bin/asciidoctor

• ARGS： --base-dir /path/to/your/root/folder/ --safe-mode safe --attribute confdir=../_conf --attribute imagesdir=../images --attribute datadir=../data --attribute codedir=../code --attribute toc --section-numbers --backend html5 --doctype book --out-file - -

• 注意在参数末尾有空格的双破折号！

• 需要为asciidoctor 指定--base-dir和—safe-mode选项，否则图像，代码和其他工件不能正确包含。

附加信息

Marked是一个OSX应用程序，用于在HTML中预览Markdown语法。可以将AsciiDoc配置为自定义Markdown处理器，以便为AsciiDoc文件创建HTML。

配置

在“标记”的行为设置中，完成以下步骤：

1.启用自定义降价处理器

2.输入asciidoc命令的路径（类似于/ usr / bin / asciidoc或/ opt / local / bin / asciidoc）

3.输入--backend html5 -o - -为args（最后的`-``将输出发送为STDOUT）

这会将当前文档发送到STDIN，并将生成的HTML显示为STDOUT。

解析包含文件

将AsciiDoc与Marked一起使用的其中一个问题是包含文件，例如：

include::myfile.txt[]

asciidoc命令在命中第一个包含文件时会死亡，因为它会尝试从工作目录中解析它，这可能不是文档的目录。

以下是有关如何解决此问题的一些想法。

选项A.

您可以使用包装asciidoc命令的shell脚本（或命令行链）将当前工作目录切换到文档目录。Marked需要一些方法来传递文档目录，以便脚本知道需要切换的位置。

选项B.

您可以将绝对包含目录设置为AsciiDoc文档中的属性，然后使用此属性为所有包含路径添加前缀。例如：

= Document Title

:includedir: /path/to/document/

Unresolved directive in - include::{includedir}myfile.txt[]

在不同的上下文中处理文档时，可以从命令行覆盖includedir属性。将文档中的设置视为后备。另一种选择是将其添加到自定义降价处理器的args中，例如-a includedir=/path/to/document/。

选项C.

您可以使用Asciidoctor，它允许您从命令行设置基本目录。我不确定如何从Marked获取文档目录，所以我们现在假设您必须对其进行硬编码。您可以指定asciidoctor而不是asciidoc的路径，并将以下内容附加到args：-B /path/to/documents

Asciidoctor的好处是它的速度是AsciiDoc的40倍。例如，来自O'Reilly 的17,000行（3,750块）企业网络书在华硕ZenBook Prime笔记本上以0.85秒呈现为HTML5 :)