Features
In the future, it will surely become your inseparable partner
Give full play to your talents！
Development
If you want to contribute code, please check the Contribution Guide in advance.
$ # Node version > v10.0.0 is requied
$ git clone https://github.com/getgridea/gridea.git
$ cd gridea
$ yarn
$ yarn electron:serve
$ yarn electron:build
from https://github.com/getgridea/gridea
https://github.com/getgridea/gridea/releases
Gridea 桌面客戶端的靜態網頁內容管理系統
在 github 看到另一款靜態網頁/網誌內容桌面編輯器 Gridea，當然要下載來親自體驗看看。
因為以 electron 寫成的，故産品相對可輕易地兼容支援跨 windows. linux, mac 三大作業系統，其打包給 linux 的執行檔格式為 AppImage，據說此下載格式更為乾淨清爽，也不必管它是 deb(for debian) 或 rpm (for Fedora, CentOS) 的打包，讓下載的 AppImage 為可執行檔案，點擊執行就會自動執行完成安裝手續。
第一次啟動 Gridea, 其文件管理庫與寫作介面如下 
快速地填寫設置選單中的網頁佈署資訊，通常透過 github repository 寄放免費的靜態網頁檔案，故填入相應的資訊取用該 repo 的授權令牌 token(權限僅同意第一列 repo 的讀取修改即可)後，就可以直接發佈到互聯網。 
成品 https://ngonewstw.github.io/gridea/ 收工。 
如果不發佈至互聯網，倒也可以將 Gridea/ publii 視之為 markdown 格式的桌面端日記本編輯器。
-------------------
-------------------
Publii Static CMS 靜態網頁內容管理系統
慢慢地變成了靜態網頁的愛好者(實情是沒錢租帶資料庫支援動態網頁的虛擬器主機)，大概個人網誌的寫作習慣就是利用 geditor 文字編輯器以 markdown 格式寫完草稿，再利用 hugo/ jekyll 靜態網頁生成器，將之轉換成 html 並推送到網路上可免費存放的空間(如 gitlab/ github/ bitbucket pages)。這幾個動作步驟稍試過幾遍熟練後，倒也不覺得有什麼不便之處，唯一小小的感嘆是：如果文件發佈後才發現有錯字或句子要修改，的確是比 wordpress/ blogger /Medium 直接登入「後台」友善的圖形介面環境要麻煩許多；再者，這種方式似乎也不適合多人以協作方式聯合經營寫作部落格（除非每一名作者都很熟悉 git 分支操作）。
後來知道兩家原以支援靜態網頁存放的服務商 forestry、Netlify 各自開發了支擾 jekyll/ hugo 兩大主要靜態網頁生成器的線上內容管理系統(CMS)。自己分別試玩過的感想是： forestry 起步較早，故教學資源、技術、介面已成熟，算得蠻容易上手建構出靜態網頁的內容管理後台，但為我個人垢病之處在於免費版用戶無法自定網域映射。而另一家 netlify 在我一年半前試玩的時，它家的 static CMS 是以 hugo 架構來設計，但我用起來卻覺得放在 jekyll 更為直覺方便， hugo 反而怪怪的，因為沒有很順，後來個人的試坃也不了了之，不知這十多個月來 netlify static CMS 是否進化地更為簡捷方便。
上週偶而看到 publii, 號稱是桌面版的 Static CMS,當然是要趕緊來試玩看看。
Publii 是利用 electron 這個專門用來製作跨平台桌面應用的 javascript 框架所打造，故支援 windows/ MacOS/ Linux 等版本的安裝。基本上只要下載完成安裝初次啟動，即進入到該程式的圖形使用介面，用戶差不多可以透由直覺的選單與設定嘗試來摸索。
Publii 目前支援 gitlab. github, netlify, AWS S3, Google Cloud, FTP/SFTP 的儲放，依照官網利用 gitlab 為例示範，很清楚的圖片教學，輕鬆地完成了gitlab 布署。(教學文中的.gitlab-ci.yml 檔案，請把第 9 行 -public/ 改成 -public)。寫好的文章草稿當然是先存在本地端電腦，可先用預覽方式查看文字內容與網誌展現樣式，這仍然只能在本地端電腦瀏覽器上看到，要其它人可以看到，須正式發佈到網路上，則按左側工具欄最下方的“Sync your website”, 它即會自動把靜態綱頁同步到網路上的 repo，使用者不必在端終機/bash 的文字操作介面下一堆 git 操作指令，即無痛地把靜態頁檔案同步到代碼檔案代管的網路服務商。
想再試著把 gitlab pages 域名轉向自己的 DN, 但似乎 gitlab 目前尚未支援自動域名的 https let's encrypt 憑證，所以暫且放棄，想來自己過去這半年來幾乎沒什麼時間好好寫自己的網誌，應該更無心再利用 publii 多開其它戰場。
若要嫌 publii 目前有什麼不足之處，大概就是: 1.) theme 外觀樣式的選項並不多，還不到十來個。若想自行設計套用，還要學個什麼“Handlebars”；2.) 內建的 TinyMCE Editor 文章編輯器尚無法支援 markdown 語法。
官网：https://getpublii.com/
项目地址：https://github.com/GetPublii/Publii
项目地址：https://github.com/GetPublii/Publii
-----------------------------------------------------------------
我们要用到「GitHub」平台，码农们都知道这个平台了，目前最大的代码托管平台，很多开源项目都可以从里面找到，现在被微软收购了，所以不用担心翻车！
使用GitHub搭建博客
1.注册 GitHub 账户：https://github.com，输入用户名、邮箱、密码，然后邮箱地址验证下就OK了。
2.点击右上角的的+按钮，选择 "New Repository" 进入创建新的仓库。
3.在 Repository name 输入你的仓库地址：你的名字.GitHub.io，再点击下面的 "Creating repository" 按钮创建。
4.创建成功后，点击右上角 "Settings" 进入设置主题样式。
5.进入设置页面，往下拉，找到 GitHub Pages 点击 "Choose a theme" 然后选择一个主题。
6.GitHub 提供主题不是很多，问题不大，后面也可以自己折腾样式修改主题。随便挑一个，点击 "Select theme" 选择。
7.设置完毕后，GitHub Pages 就会生成网站了，现在访问你刚才填写的地址xxxxx.GitHub.io 就能打开了。雷锋哥这里的是：https://xia1ge.github.io
8.接下来可以在 GitHub 里面编辑写作，新增页面等，支持 Markdown 语法。但是这样的编辑不太友好，所以下面要给大家推荐「Gridea」客户端，用来管理 GitHub Pages 页面。
使用Gridea写作
这款「Gridea」是基于 Github Pages 的免费开源页面管理工具，支持 MacOS / Windows / Linux 平台，只需要配置好你的 Github 参数信息就可以使用。
平台：选择Github Pages
域名：输入仓库地址
仓库名称：你页面存放的仓库地址
分支：默认是master
仓库用户名：你的账户用户名
邮箱：你的Github邮箱地址
CNAME：如果你有独立域名可填
令牌：打开 https://github.com/settings/tokens 页面，点击 "Generate new token"
输入 token 的名称，Select scopes 只选择 "repo" 就可以了，最下面点击 "Generate token" 创建。
绿色框里面那一段字符就是令牌，复制粘贴到「Gridea」配置界面里面就可以了。
一切都设置完毕后，点击左下角的 "检测远程连接" ，提示远程连接成功就没什么问题了。
接着可以设置主题、网站名称、网站描述、网站图标、头像图标、布局、自定义CSS样式等，设置完毕后，点击右下角的同步按钮。
写文章方面，样式格式需要用 Markdown 语法，不会的网上找下教程，很简单的。
功能上支持插入图片、插入表情、查看字数、设置文章URL、封面、标签、置顶等。写完文章可以点击一下预览效果，没问题后，可点击右上角的保存，点击同步按钮发布。
下面是发布出来的效果了，你还可以对归档页面、标签页面、个人关于页面等进行设定，这样一个属于自己的轻博客就完成啦。
安装其它主题
官方提供的主题过于简单，选择也少，可以安装大佬们制作的精美主题。打开主题页面 https://gridea.dev/themes/ 选择你要的主题下载。
打开「Gridea」的设置，看到站点源文件路径，例如我这里是："E:/我的文档/Gridea" 位置。
打开 E:/我的文档/Gridea/themes 文件夹，把下载的主题解压放进去，然后重启「Gridea」软件。
然后进入「Gridea」主题设置，选择你刚才安装的主题，保存同步完成。
绑定域名
如果你觉得 xxxxx.GitHub.io 域名不够酷，也可以自己购买一个域名，然后通过 CNAME 方式把你的 域名 指向 xxxxx.GitHub.io 地址就可以了。不会解析的，参考下图的设置。
接着进入 "Settings" 设置界面(参考上面步骤4)，找到 "Custom domain" 输入你的域名地址，例如：blog.xiaoyi.vc，然后点击 Save 保存。接着耐心
再次进入 "Settings" 设置界面找到 "Custom domain"，看到 "Your site is published at http://blog.xiaoyi.vc" 证明成功了，需要HTTPS的模式，可以勾选下面的 Enforce HTTPS，然后等待证书生效就行了。
最后打开「Gridea」客户端，进入设置，把 CNAME 填上你的域名保存就OK了。
正常情况下是没问题的了，如果打不开，可能解析还没生效，还需要在等等一会。
注意事项
「GitHub」虽然免费，但是还是有一些限制的，仓库限制1G容量（用来码文字其实够写很多了，实在不够，那就再新建一个仓库）单个文件大小上传限制100M，每个月流量100GB，基本都够用了。
还有个问题，为什么我发布的文章或设置的东西，没有显示出来？因为有缓存机制，需要等待1-5分钟后才会刷新内容。
总结
「Github Pages」可以说是轻博客最佳的选择了，如果你平时只是用来记录文字日志图片，不需要太复杂的功能，其实完全够用了，加上托管在「GitHub」你不用担心服务器的各种问题，如漏洞、到期忘续费、数据丢失等，最最最重要是完全免费。
另外「GitHub」因为服务器在国外，有时候访问会慢，可以利用免费的CDN「jsDelivr」来加速，有空了再来给大家分享。另外也有大佬用「Github」+「jsDelivr」+「PicGo」打造免费高速图床，同样后面有机会再分享。
下载
官方网站：https://gridea.dev
客户端：https://www.lanzoux.com/b05gas50f(密码:ctsu)
相关教程
MarkDown教程：https://github.com/mzlogin/markdown-intro
gridea教程：https://gridea.dev/docs
Github Pages网站参考:
https://gridea-theme-rocky.netlify.app
https://ryanc.cc
使用GitHub搭建博客
1.注册 GitHub 账户：https://github.com，输入用户名、邮箱、密码，然后邮箱地址验证下就OK了。
2.点击右上角的的+按钮，选择 "New Repository" 进入创建新的仓库。
3.在 Repository name 输入你的仓库地址：你的名字.GitHub.io，再点击下面的 "Creating repository" 按钮创建。
4.创建成功后，点击右上角 "Settings" 进入设置主题样式。
5.进入设置页面，往下拉，找到 GitHub Pages 点击 "Choose a theme" 然后选择一个主题。
6.GitHub 提供主题不是很多，问题不大，后面也可以自己折腾样式修改主题。随便挑一个，点击 "Select theme" 选择。
7.设置完毕后，GitHub Pages 就会生成网站了，现在访问你刚才填写的地址xxxxx.GitHub.io 就能打开了。雷锋哥这里的是：https://xia1ge.github.io
8.接下来可以在 GitHub 里面编辑写作，新增页面等，支持 Markdown 语法。但是这样的编辑不太友好，所以下面要给大家推荐「Gridea」客户端，用来管理 GitHub Pages 页面。
使用Gridea写作
这款「Gridea」是基于 Github Pages 的免费开源页面管理工具，支持 MacOS / Windows / Linux 平台，只需要配置好你的 Github 参数信息就可以使用。
平台：选择Github Pages
域名：输入仓库地址
仓库名称：你页面存放的仓库地址
分支：默认是master
仓库用户名：你的账户用户名
邮箱：你的Github邮箱地址
CNAME：如果你有独立域名可填
令牌：打开 https://github.com/settings/tokens 页面，点击 "Generate new token"
输入 token 的名称，Select scopes 只选择 "repo" 就可以了，最下面点击 "Generate token" 创建。
绿色框里面那一段字符就是令牌，复制粘贴到「Gridea」配置界面里面就可以了。
一切都设置完毕后，点击左下角的 "检测远程连接" ，提示远程连接成功就没什么问题了。
接着可以设置主题、网站名称、网站描述、网站图标、头像图标、布局、自定义CSS样式等，设置完毕后，点击右下角的同步按钮。
写文章方面，样式格式需要用 Markdown 语法，不会的网上找下教程，很简单的。
功能上支持插入图片、插入表情、查看字数、设置文章URL、封面、标签、置顶等。写完文章可以点击一下预览效果，没问题后，可点击右上角的保存，点击同步按钮发布。
下面是发布出来的效果了，你还可以对归档页面、标签页面、个人关于页面等进行设定，这样一个属于自己的轻博客就完成啦。
安装其它主题
官方提供的主题过于简单，选择也少，可以安装大佬们制作的精美主题。打开主题页面 https://gridea.dev/themes/ 选择你要的主题下载。
打开「Gridea」的设置，看到站点源文件路径，例如我这里是："E:/我的文档/Gridea" 位置。
打开 E:/我的文档/Gridea/themes 文件夹，把下载的主题解压放进去，然后重启「Gridea」软件。
然后进入「Gridea」主题设置，选择你刚才安装的主题，保存同步完成。
绑定域名
如果你觉得 xxxxx.GitHub.io 域名不够酷，也可以自己购买一个域名，然后通过 CNAME 方式把你的 域名 指向 xxxxx.GitHub.io 地址就可以了。不会解析的，参考下图的设置。
接着进入 "Settings" 设置界面(参考上面步骤4)，找到 "Custom domain" 输入你的域名地址，例如：blog.xiaoyi.vc，然后点击 Save 保存。接着耐心
再次进入 "Settings" 设置界面找到 "Custom domain"，看到 "Your site is published at http://blog.xiaoyi.vc" 证明成功了，需要HTTPS的模式，可以勾选下面的 Enforce HTTPS，然后等待证书生效就行了。
最后打开「Gridea」客户端，进入设置，把 CNAME 填上你的域名保存就OK了。
正常情况下是没问题的了，如果打不开，可能解析还没生效，还需要在等等一会。
注意事项
「GitHub」虽然免费，但是还是有一些限制的，仓库限制1G容量（用来码文字其实够写很多了，实在不够，那就再新建一个仓库）单个文件大小上传限制100M，每个月流量100GB，基本都够用了。
还有个问题，为什么我发布的文章或设置的东西，没有显示出来？因为有缓存机制，需要等待1-5分钟后才会刷新内容。
总结
「Github Pages」可以说是轻博客最佳的选择了，如果你平时只是用来记录文字日志图片，不需要太复杂的功能，其实完全够用了，加上托管在「GitHub」你不用担心服务器的各种问题，如漏洞、到期忘续费、数据丢失等，最最最重要是完全免费。
另外「GitHub」因为服务器在国外，有时候访问会慢，可以利用免费的CDN「jsDelivr」来加速，有空了再来给大家分享。另外也有大佬用「Github」+「jsDelivr」+「PicGo」打造免费高速图床，同样后面有机会再分享。
下载
官方网站：https://gridea.dev
客户端：https://www.lanzoux.com/b05gas50f(密码:ctsu)
相关教程
MarkDown教程：https://github.com/mzlogin/markdown-intro
gridea教程：https://gridea.dev/docs
Github Pages网站参考:
https://gridea-theme-rocky.netlify.app
https://ryanc.cc
No comments:
Post a Comment