想法

昨天有了想做一个小小的钢琴学习记录和展示的网站后，上 GitHub 感觉一发不可收拾。 果然一带着目的去做，灵感激发后就源源不断。 而且我觉得把之前做的东西捡起来，也比我想象中容易。虽然很久没接触了，但是感觉自己很轻车熟路的就知道要找些什么东西，在哪里找，以及怎么看文档等等。 这次我还想能够给自己写一个 handbook，方便以后继续做。

一、主力方案：Bitcron + MarkEditor（电脑） / Metion（手机）

方案设计

1 个人专题小站：Bitcron - 主题 Wiki http://musicclass.zoejane.net/

2 Blog：Bitcron - 主题 Fexo https://blog.zoejane.net/

3 个人主页：Bitcron - SmartPage http://demo.zoejane.net/

使用场景

1 Metion（手机）/ MarkEditor（电脑） 上编辑
2 MarkEditor 上一键发布

体验

1 本地编辑后，点击上传，瞬间发布，太轻松了。 一旦拥有，别无所求呀。 2 HTML 的 code 直接拷贝进去就行，可以方便的发布多媒体。 3 不过年底 Bitcron 可能会停掉， FarBox 可能也没有这么多功能了。 但是可以尝试和海波联系，以及尝试付费使用。

二、备选方案

方案设计

1 个人专题小站：Mkdocs + Material 模版 / GitBook 2 Blog：GitHub Pages / Netlify + Hugo 3 个人主页：Divi + Wordpress / HTML + CSS 上传单个页面

个人专题小站：Mkdocs + Material 模版

https://zoejane.github.io/music-mkdocs/

1 github 建立 repo 2 mkdocs 建立小站 mkdocs new . 3 安装 material https://squidfunk.github.io/mkdocs-material/getting-started/

  • 下载：pip install mkdocs-material
  • 使用：修改 mkdocs.yml 
theme:
  name: material

4 使用Github Pages 进行 deploy

https://squidfunk.github.io/mkdocs-material/publishing-your-site/

方式1：使用 mkdocs gh-deploy 方式2：使用 Github actions 笔记：github actions运行出错的解决方案

  • 查看action的运行日志发现错误
  • Google search: remote: Permission to denied to github-actions[bot].
  • 找到 https://github.com/ad-m/github-push-action/issues/96
  • 找到我的 Setting- Actions permissions - Workflow permissions 修改为 Read and write permissions

5 修改网站显示的目录

参见源代码： https://github.com/squidfunk/mkdocs-material/blob/master/mkdocs.yml

6 以后只要直接修改md，push，就可以自动触发网站发布了。 修改 Github 网页（手机）/ Sublime 编辑 + Push（电脑）都可以。

个人专题小站：GitBook

https://zoejane.gitbook.io/music-gitbook/

1 Gitbook 和 GitHub 链接

  • 看GitBook文档
  • GitHub需要有分支，可以建立.gitignore 2 在本地进行修改 GitHub Desktop + Sublime 3 多媒体
  • 可以直接 上传音频到gitbook / 链接网址，以文件的形式在新网站打开预览
  • 可以 embed 到YouTube 等外部网站
  • 暂时不能添加音频播放器，不能随意添加 html 代码

Blog：GitHub Pages

https://github.com/zoejane/zoejane.github.io 修改_posts 文件夹

Blog：Netlify + Hugo

https://blogs.zoejane.net/

个人主页：Divi + Wordpress

https://zoejane.net/ 考虑是否搬迁到用阿里云，国内访问速度慢

个人主页：HTML + CSS 上传单个页面

  • 自己用其他方式做的，如 Bitcron 的 SmartPage / Divi + Wordpress 制作后，直接保存编辑后上传 html + css
  • 网上看到的好看的，如 https://taylantatli.github.io/Moon/

其他

1 参考别人的做得好的 portfolio - https://ellekasai.com/

2 属于自己的 GitHub Wiki https://github.com/DebugUself/du4proto/wiki https://github.com/OpenMindClub/Share/wiki

3 属于自己的 GitHub Awesome List / Repo https://github.com/ouyangzhiping/awesome-cognitive-science https://github.com/zoejane/IAToolkit https://github.com/ishanshan/CollaborationGuide4Shaper

Changelog

  • 20220504 zoejane init