前言
公开「元类型」暂无说明。
包说明.html模块 / 2
总集。豫
「元类型」暂无说明。
(「列」于(「字符串」合「字符串」))文言:前言之空者。汉语:空前言。
化(「列」于(「字符串」合「字符串」))而化「字符串」而「字符串」文言:取前言之值,无则空串。汉语:按键取前言的值,没有这个键时得空串。
化(「列」于「字符串」)而「字符串」文言:解双引号内之转义。汉语:还原双引号字符串里的反斜杠转义(\" 与 \\ 等,反斜杠后的字符原样保留)。
化「字符串」而「字符串」文言:前言之值,去两端之引号。汉语:前言里的值:去掉首尾空白;两端是双引号时去掉并还原转义;两端是单引号时去掉并把 '' 还原为 '。
化「字符串」而(「或可有」于(「字符串」合「字符串」))文言:分串于首见之冒号。汉语:在第一个冒号处把字符串分成(冒号前,冒号后);没有冒号时得可无。
化「字符串」而(「或可有」于(「字符串」合「字符串」))文言:析一行为键值;空行、注释与无冒号者无之。汉语:把一行解析成(键,值);空行、注释行与没有冒号的行得可无。
化(「列」于「字符串」)而(「列」于(「字符串」合「字符串」))文言:析诸行为前言。汉语:把前言各行解析成前言。
化「字符串」而「爻」文言:三短横之界行乎。汉语:是否为前言的分界行 ---(行尾空白不计)。
化「字符串」而(「或可有」于((「列」于(「字符串」合「字符串」))合「字符串」))文言:分文为前言与正文。汉语:把文本分成(前言,正文);第一行不是 --- 或找不到结束的 --- 时得可无。正文是结束行之后的全部内容。
化(「列」于(「字符串」合「字符串」))而化(「列」于(「列」于(「字符串」合「字符串」)))而(「列」于(「列」于(「字符串」合「字符串」)))文言:一项之前言入列。汉语:把已收集的一项(逆序)按原顺序加入项列表;空项不加。
化「字符串」而化(「列」于(「字符串」合「字符串」))而(「列」于(「字符串」合「字符串」))文言:析一行而添入本项。汉语:解析一行“键: 值”,加到当前项(逆序);解析不出时不变。
化「字符串」而(「列」于(「列」于(「字符串」合「字符串」)))文言:析平铺映射之列:「- 」起一项,缩进之行续之。汉语:解析平铺的映射列表:以“- ”开头的行开始新的一项,后面缩进的“键: 值”行属于这一项;空行与注释行跳过。
「元类型」暂无说明。
化「字符串」而「站点文件」暂无说明。
化「字符串」而化「字符串」而化(「列」于(「字符串」合「字符串」))而化「字符串」而「站点文件」暂无说明。
化「字符串」而化「字符串」而「字符串」文言:合根与相对之径。汉语:把根目录与相对路径合成路径;相对路径为空时就是根目录。
化「字符串」而化「字符串」而「字符串」文言:目录之相对径加一名。汉语:在目录的相对路径后加一个名字;目录为空时就是这个名字。
化「字符串」而「爻」文言:标记文之页乎。汉语:是否为 Markdown 文件(.md 或 .markdown)。
化「字符串」而化「字符串」而化(「列」于「字符串」)而化(「列」于「字符串」)而「爻」文言:略此文乎:在排除之列者略之;名以「.」「_」起者亦略之,惟在包含之列者存之。二列皆书相对源目录之径。 汉语:是否跳过这个文件或目录:在排除列表里的跳过;名字以“.”或“_”开头的也跳过,除非在包含列表里。两个列表都写相对源目录的路径。
化「字符串」而化(「列」于「字符串」)而化(「列」于「字符串」)而(「列」于「字符串」)文言:列源目录之诸文(相对之径)。汉语:递归列出源目录下所有要处理的文件(相对路径)。
化「字符串」而化(「列」于(「字符串」合「字符串」))而「字符串」文言:页之网址:有 permalink 者从之;否则标记文之页易其尾为 .html。汉语:页面的网址:前言有 permalink 时用它;否则是“/”加相对路径,Markdown 文件的扩展名换成 .html。
化「字符串」而「字符串」文言:网址所当之文件(相对出之目录);以「/」终者为其 index.html。汉语:网址对应的输出文件(相对输出目录):去掉开头的“/”;以“/”结尾或为空时加 index.html。
化「字节串」而「爻」文言:字节以三短横起乎。汉语:文件内容是否以三个短横线开头(按字节判断,二进制文件也可安全检查)。
化「字符串」而化「字符串」而「站点文件」文言:读一文:以三短横起而得前言者为页,余为静文。汉语:读取一个文件:以 --- 开头并解析出前言的是页面,其余是静态文件。Markdown 页面在这里转换成网页片段。
化「字符串」而化(「列」于「字符串」)而化(「列」于「字符串」)而(「列」于「站点文件」)文言:读全站。汉语:读取整个源目录,得到站点文件列表。
化「字符串」而化「字符串」而化「字符串」而「有」文言:复制静文,以字节为之。汉语:按字节复制一个静态文件。待办事项:目标目录由 Node 宿主的写文件自动创建,其他宿主未必如此。
化「字符串」而化「字符串」而化「字符串」而「有」文言:书页于其网址所当之文件。汉语:把网页写到网址对应的输出文件。
化「字符串」而(「或可有」于「字符串」)文言:入站图之网址:网文之页与静文;index.html 省为目录。汉语:站点地图收录的网址:以 .html 或“/”结尾的网址;末尾的 index.html 省略成目录。
化「站点文件」而「字符串」文言:站中一文之网址。汉语:站点文件的网址:静态文件是“/”加相对路径,页面用其网址。
化(「列」于「站点文件」)而(「列」于「字符串」)文言:站图所收之网址。汉语:站点地图收录的全部网址。
化「字符串」而化(「列」于「字符串」)而「字符串」文言:站图之文。汉语:站点地图(sitemap.xml)的内容,格式同 jekyll-sitemap;网址直接用中文。
化「字符串」而「字符串」文言:robots.txt 之文,指站图所在。汉语:robots.txt 的内容:指明站点地图的位置。
化「字符串」而化「字符串」而化「字符串」而化化「站点文件」而「字符串」而化(「列」于「站点文件」)而「有」文言:成站:静文复制,页经套版而书之;终书站图,源无 robots.txt 则亦书之。 汉语:生成站点:静态文件原样复制;页面交给套版函数得到完整网页后写出;最后写站点地图,源目录没有 robots.txt 时再写一份。