做静态页面个人网站的详细步骤

今天 海云青飞 把个人网站 整体观文明 更新了一下,这里记录一下做个人网站的几个要点,方便大家参考

静态网站胜过动态网站

我建议是做静态页面的网站,这样技术难度小,几乎不需要在维护上花时间

文本的源文件用 Markdown 格式

Markdown 格式的好处是文章的格式化用简洁的标记直接写在了源文件里,用过了这种方式写作就再也离不开了

用软件 Mdbook 把 Markdown 源文件格式化成 HTML 网页格式

个人认为,简单的个人网站,用开源软件 Mdbook 是最佳的方案

本地文件怎么保存

申请一个云盘,把所有源文件保存在云盘里,重要资源就再也不会丢失了

我介绍一下本地文件夹的目录结构

src 目录下保存网站的源文件,下面新建几个目录分别作为大类目录,比如说 2021,2021 是大目录,保存2021年创作的内容

2021 目录下新建一个目录,作为一篇文章的目录,所有的目录名和文件名都要用英语字符命名。这里的目录名是 0114-first-article,0114 表示日记的写作日期是 1 月 14 日

再在 0114-first-article 目录下新建 index.md 文件,文章就写在这个文件里

如果有图片的话,在 0114-first-article 目录下新建 img 目录,所有图片放在里面

mdBook SUMMARY.md 文件的组织

只有在 SUMMARY.md 文件里列出的 .md 文件,mdBook 才会把它们编译成 HTML 文件

在本机里,所有 .md 文件按年分目录存在,这样本机分类清晰,管理方便

而在 SUMMARY.md 里则多数文章归入不同的专题目录,暂时没有归属专题目录的文件则按年归类,如 2023 年创作的文章归入 2023 目录

这样把文件归类的好处是所有文件可以自由进出任何的专题目录

另外,某年创作的所有文章都要在所属年的页面全部列出来,这样方便按年查看自己创作的文章。比如 2023/index.md 页面就列出 2023 年创作的所有文章,按日期排序,每行前面标上创作的日期

怎么把文件上传到服务器并编译成网页

你需要有一个支持静态文件的服务器,并且服务器可以自主安装软件

写一个 Bash 脚本文件,脚本的任务是自动查出当天修改过的文件,压缩它们,然后上传到服务器,在服务器上解压,调用你安装好的 Mdbook 编译出网页。这些步骤需要你有一定的计算机技术基础。不过也不是很难,海云青飞 并不是计算机相关专业毕业的,多查查资料,慢慢就会了

以上讲的步骤,对于有技术基础的人来说,并不复杂,这里重点要说的是我的二个微创新

以字母 zz_ 开头命名的位置名表示暂时忽略

今天我在整理《悟道进化生物学》和《修行是最大的骗局》,每篇文章的图片都分别保存在 img 目录里,但是我暂时不想在文章里插入图片,怎么办呢?就把 img 重命名成 zz_img 就可以了,当然还得在上传文件到服务器的脚本里设置忽略 zz_ 开头的位置

如果哪篇文章要插入图片,把该文章的图片目录名 zz_img 改成 img 就可以了

把网站的一些非重要文件放到 z 目录

比如 “关于我们”,“联系我们”,网站图标等文件,都放到 z 目录

为什么用字母 z 命名目录?因为字母 z 是最后一个字母,目录排序在后面的位置

你可以打开 整体观文明 的网站 www.tuenhai.com 看一下效果,如果你也喜欢极简的风格,那就更好

2020-01-14

2023-02-09


独立思考最难得,赞赏支持是美德!(微信扫描下图)

迷路了,百度搜索 海云青飞 官方网站 就可以随时找到回家的路