GitHub博客编写与主题

博客编写和主题

markdown语法

语法简单，可以边写边学。 - 列表 1. 无序列表 - 减号+空格 - 继续减号+空格

2. 有序列表
   1. 数字+”.“加
   2. 继续数字+”.“加空格
   3. 列表中列表注意前方加空格
3. 列表在不同软件中呈现效果不一 先输入完整列表标题，再展开内容写作。 注意列表标题及小标题层次。

换行继续输入文字自动结束列表

• 双星号加粗，单星号斜体

• 字号字体用html标签

• 数学公式用latex语法，不会的可以在iPhone或iPad上使用mathpad手绘公式，然后输出latex语法直接粘贴到md文档中去。

主题编辑

• 进入Hexo官网主题页面
• 找到喜欢的开源主题
• 进入主题
• 找到主题的网页地址
• 好心的主题开发者会在博客中留下主题安装的指引，跟着指引走就行。下载完整的主题可能需要很长时间，务必耐心。
• 终端中使用“git clone https://github.com/fi3ework/hexo-theme-archer.git themes/archer”命令，网址后面不要忘记加” .git “。最后的themes/archer是主题目录里的主题名称，可以自己命名，在config文件中保证名称一致即可。
• 打开博客目录中的config文件，编辑theme为主题名称。
• 打开主题目录中的config可以编辑菜单，不一定所有的主题都一样，这里只是示例。同样，好心的博主会留下主题设置的引导。 menu: #配置页头显示哪些菜单 Archives: /archives Reading: /reading About: /about
• about页面可以通过博客目录下 hexo new page “about” 建立。source文件夹中会建立一个about.md文件，直接进去输入内容即可。
• 终端回到博客目录，hexo g，hexo s，本地查看主题效果。进一步调整细节，即可发布。
• 终端可以开多个窗口，同时进行多个进程，比如一个窗口专门做hexo任务，同时另一个窗口可以一直在下载主题。

静态博客网页及主题编辑中遇到的问题和解决方案

1. 如何选择主题
   • 主题选择主要看功能，是否有菜单？文章列表是否清晰明了？首页文章呈现方式？是否能搜索？是否能分类？是否能标签？是否能评论？一切以简捷实现功能为要。
   • 主题选择还要看主题作者是否提供主题安装的引导，有的主题虽然好看，但是po主不知道把引导放在哪里，那么要针对功能进行个性化就很难。
   • 有的主题首页只呈现文章标题，不显示文章内容，这个没法通过根目录与主题目录中的两个config文件进行调整，介意的同学请割爱。
2. 博客根目录下的config文件中可以个性化的内容
   1. 博客根目录下config个性化内容，自上而下
   • title。默认hexo，可调整为自己喜欢的内容。
   • subtitle
   • author
   • language 默认en，可以调整为zh-CN，前提是themes/***/layout/languages/目录中有zh-CN语言包。
   • timezone 出国以后可以改，空着也无所谓
   • url 改成自己的主页路径
   • directory就是根目录下面放不同文件的子目录，有时候会莫名出现路径错误，对照一下是否一致。
   • default_category 默认uncategorized，可以修改为自己喜欢的分类，管理文章的时候方便。 文章建立分类和标签要在title下面添加“ categories: - name ”和“ tags: - name ”语句。
   • theme 这个是肯定要修改的，theme目录下会出现多个theme也很正常，修改主题目录名称以便管理，这里就要相应修改。
   2. 博客根目录下文件个性化
   • /source/_posts/ 这个文件夹就是存放文章的地方，可以用hexo new “名称”的命令新建文章，要修改文章就在这里找，不支持文件夹。
   • /source/about/ 这个文件夹里的index文件是存放about内容的，直接编辑内容即可。
3. 主题根目录下config文件中可以个性化的内容
   1. themes目录中config个性化内容，主题不同，config的内容就不同，这里以本博使用的pure主题为例，可以自行研究。 https://github.com/cofess/hexo-theme-pure 这是主题的路径。
   • menu 可以用#放在行首隐藏不需要的menu，注意不要随意修改导致名称不一致，包括大小写，后续可能会无法使用menu
   • title 页面标题
   • board 站点公告，放在首页的介绍、通知之类
   • copyright
   • skin layout toc 这些都是pure主题开发者自己设计的内容，其他主题会不一样，看到了可以研究研究效果，hexo g然后hexo s，然后就可以在本地浏览器上测试。
   • archive_type 默认“monthly”，可以改成按天还是按年，可以自行测试。
   • share pure作者还贴心地安排了分享按钮，可以自行调整。
   • github 不管在哪里看到这个，先把自己的GitHub账号拿出来填进去
   • 评论部分专题说
   • avatar 不一定每个主题都象pure作者这样分类清晰，有的就把avatar放在别处，但是avatar是博客上显示的头像，找到主题目录下source/images/，在里面放上自己的头像，然后avatar: images/***.jpg。
   • author
   • author title
   • author_description
   • location 出国以后要改
   • follow 吸引一下小伙伴吧
   • social link 不想填那么多就#掉一些
   2. 主题目录下文件个性化
   • 语言包 语言包yml文件内容很简单，冒号前面是功能，冒号后面是显示出来的字样，home;home，就是首页显示为home，改成home:首页，就呈现为中文“首页”。想搞怪可以在这里编辑一些吓人的内容。
   • 上文提到可以在根目录config中修改语言，实测没有效果，所以变通的方法就是修改语言包，我就是把en和cn-ZH两个文件名互换了，国高学生的blog是有目的性的，不建议过分个性化。等以后社会人了再尝试个性化也可以。
   • 有的主题是有head图片和其他图片的，可以在images里找到并替换成自己的图片。
   • ejs类文件不要乱改，除非有网页设计经验。
   3. 重点说一下评论框
   • 请使用gitalk。重要的事情说三遍：不要尝试其他！不要尝试其他！不要尝试其他！都不能用了。
   • https://www.cnblogs.com/qisi007/p/13731562.html 教程在此。
   • 跟着教程走，基本没问题。但是最后一步article.ejs文件中添加代码，这一步要跳过。会影响到博客部署后的效果，出现一张白纸之类的。但也有可能是不同主题设计的差异，根据自己选择的主题进行设置。如果主题中不包含评论框，就不要花时间去研究了，另外找一个带评论框的主题进行设置吧。pure主题中包含了多个评论框的设置，调节起来比较方便。

Summary

• 从接到任务开始到全部完成GitHub的搭建，总共花费了约36个小时，不断踩坑是最主要的费时因素。
• 从零开始搭建GitHub对高中生里占大多数的计算机素人来说是个很严峻的挑战，文件目录系统与文件命名规则的了解与熟悉，命令行操作方式的了解与熟悉，代码的输入与逻辑，测试方法与debug的方法和逻辑，这个部分的思路培养其实是CS课上不会成体系教授的，需要花费一点时间来熟悉，一旦掌握了思路，很快就能驾轻就熟。
• 搭建GitHub博客的目的，对国高学生来说，目前就是升学。玩出花儿来也不过如此，切忌过分，最好能配合自己的升学方向做相应的调整，成为升学的助力。
• 主题发布者绝大多数会夹带私货，毕竟是个人的主题，所以会有一些奇怪的链接之类是我们不需要的，尽管删除，或者学着替换或加入自己的内容。
• 再次提醒：GitHub博客在国内毕竟还是小众，而且目的不是社交。作为文章库的存在，应该以写作为重心，关注的是内容。主题再花哨，不如一目了然。尤其是以升学文档为主体的国高学生，应该更重点关注的是markdown的写作方式。结构化写作，没有比markdown更适合的文本写作工具了。而latex之类数学公式的支持又使得理科生在绝望中看到一线曙光，配合iPad等平板电脑及Apple pencil等硬件工具，还有mathpad之类数学公式手写软件，再复杂的方程和公式也可以轻松以最直接自然的方式生成。
• 不是所有的家长都有相关经验，遇到问题可以选择向老师或学长咨询，有时间的可以自行研究，但是不建议花费太多时间去试错，网上搜索教程虽然也是一种方法，但是很多教程已经是几年前的内容了，很多东西已经过时，这种时候多问一句，可能会节省几个小时甚至更多。
• 关于markdown，为什么要强调结构化写作，这是一种非常好的实用写作方法。要写一篇实用文，先打个草稿或者腹稿，然后写出提纲，然后一段一段在提纲下写出内容。整篇文章就不会散乱或者偏楼。这种写作习惯在我们以往的教育中是体现为不同的体系的，与markdown的写作方法并不能很好兼容。尽快适应markdown的写作方法，对即将到来的文书写作是有很大的帮助的。另外，GitHub博客的后台对于文档管理也是有很大的帮助的，也需要尽快熟悉掌握。
• 最后，hexo d 部署上传会有一点delay，不一定马上就能在浏览器里刷新最新的结果，耐心等待一下，会有的。
• 最最后，苹果系统跨平台操作能力超强，有条件的一定要尝试一下，在iPad上写作，复制黏贴到Macbook上的文档里。iPad可以作为MacBook的第二块屏幕显示不同的桌面。终端可以开几个窗口，一边运行hexo s，一边运行hexo g，修改的内容可以即时在本地刷新查看效果，同时还可以写作。Mac的快捷键也一定要用，在终端里反复生成静态页面，可以用上箭头键，直接重复上一条命令，不用反复敲键盘了。cmd-c cmd-v cmd-z shift-cmd-z，这些快捷键都要熟悉，另外在搭建过程中会用到截屏、保存、新建、新开窗口等，都有对应的快捷键，可以在菜单里找到相应的快捷键。

​