【区块链】使用MDWiki需要自动化的一些工作(五十六)
2019-01-16 本文已影响8人
浩然H_H
今天把MDWiki做了一些修改,主要是过去写的那些文章的索引,以下步骤参考了MDWiki的README
MDWiki的目录结构
这里所有的文件都是指对应语言目录下的文件(比如我的zh
目录)
文件名 | 类型 | 说明 |
---|---|---|
index.md |
File | 主要的索引文件,可以说是整个Wiki的首页。 注意不是 index.html , 是 index.md ! |
navigation.md |
File | 一些其他设置(比如,名字啊,菜单啊等等) |
config.json |
File | 程序用到的配置文件,基本不需要修改 |
pages |
Folder | 最好把所有的文章(xxx.md )都放到这个目录下面,可以根据需要创建子目录 |
uploads |
Folder | 这个目录通常可以用来放一些上传的文件, 当然最好是把这些文件放到别的地方,比如Dropbox,或者CDN等等,反正不建议放GitHub |
拷贝过往文章内容
我将过去写的文章(一个名为writing
的目录)整个挪到了pages目录下,包括一些文章中用到的小小图片。因为图片不多,我就没管人家说不建议放GitHub的提议。
修改配置及索引文件
然后,依次修改config.json
,navigation.md
,index.md
,并且为我的每一类文章增加了一个对应的索引文件(随笔.md
,生命⋅修行.md
,区块链.md
,创业.md
),中文文件名完全没问题,这让我很开心😄
config.json
{
"additionalFooterText": "All content and images © by Hooman <br>",
"anchorCharacter": "#",
"lineBreaks": "gfm",
"title": "Hoo‘s Wiki",
"useSideMenu": true
}
这是一个Json格式的配置文件,第一行是显示在整个页面下方的版权信息,最后一行是要不要左侧的菜单。
mavigation.md
<!--
-- Name of your wiki
-- Do NOT remove the leading `#` character.
-->
# 浩然文集
<!--
-- Default theme
-- (Read: http://dynalon.github.io/mdwiki/#!customizing.md#Theme_chooser)
-->
[gimmick:theme](spacelab)
<!--
-- Navigation
-- (Read: http://dynalon.github.io/mdwiki/#!quickstart.md#Adding_a_navigation)
-->
[随笔](pages/随笔.md)
[生命⋅修行](pages/生命⋅修行.md)
[区块链](pages/区块链.md)
[创业](pages/创业.md)
[我的简书](https://www.jianshu.com/u/0f2c2131d6af)
文件里面的注释很清楚,照着注释的例子修改即可。我只修改了网站的名字、以及最上方的菜单,也就是我自己为每一类文章单独创建的索引。顺便还加了一个到简书的链接。
index.md
这个文件就是网站的主页内容了,想写什么就写什么,只要按照Markdown语法即可。可以参考学习下GitHub的Markdown指南,和MDWiki的Quick Start指南。对我来说,最重要的是怎样链接到我之前写的那些文章。其实很简单,就像下面这样,方括号[]
内是显示的文字,圆括号()
内是我文章的文件名(注意这里需要用相对路径)。
[20181121【随笔】开始一次新的尝试(一) ](pages/writing/20181121【随笔】开始一次新的尝试(一) .md)
其他索引文件
和编辑index.md一样,想怎么编辑就怎么编辑。
自动化的需求
其实,我并不想费功夫编写这些索引文件。但是,目前这是必须的工作,每新增一篇文章,我至少需要在一个地方增加索引,才可能从MDWiki的首页或某个菜单访问。接下来可以写个脚本自动刷新索引,同样的,也可以用另外一个脚本或程序索引提交到IPFS。