There are many themes out there, yet none of them suits my need.
raw.githubpage, like this
<img src="https://raw.githubusercontent.com/yk-liu/PointingToTheMoon/master/_posts/2018-12-11-Jekyll-Build/assets/GitHub-desktop.png" width="80%">. I consulted GitHub, and they said it’s okay to do so.
Now I ended up with this theme. I know it’s not perfect, but I will settle it for now. I will consider any suggestions you guys make, you can comment it in this page.
About the extended markdown syntaxes, you can see it here.
username.github.io. You don’t need to buy your own domain. PS, All domains must be registered by the owner using a personal ID. So that saves you a ton of trouble. But GitHub pages also allows you to
ruby; you don’t need you locally build your website and publish it. You simply commit your source code and that’s all.
push(a fancy name for upload) to GitHub. Things like equations, lists, tables, mermaid-diagrams, images, or videos are automated supported. This means all you’ll need is a text editor as simple as good old notepad.exe to write your post, yet I strongly recommend
typora. As the time of writing, it is free.
You have absolute control over anything.
There is a nice touch. GitHub’s famous for being used by techies.
Having your own website built entirely by yourself.
GitHub Pages source repositories have a recommended limit of 1GB. Published GitHub Pages sites may be no larger than 1 GB. GitHub Pages sites have a soft bandwidth limit of 100GB per month. GitHub Pages sites have a soft limit of 10 builds per hour. See here
I am going to assume that you know the basic operations of git. If not, download the GitHub Desktop, and do everything in GUI. For the majority of bloggers, only commit and push is required. For you to publish your work, save your file in your editor, go to GitHub Desktop, commit your changes, and push.
Clone this repo and publish it!
Here is a list of files you need to modify
FIRST: If you are using the “yk-liu.github.io” repo, REMOVE ALL INFO ABOUT YK-LIU. If you are using “/PointingToTheMoon” repo, you can ignore this step. Including personal description in
/about/index.md and my CV at
License.md: add your version of license at the beginning of the file.
Readme.md: add your description.
config.yml: fill in as much as you can. Also see step 7.
index.html: fill in the description and (if any) proposed posts.
Register at commentit.io. This enables your website’s comment feature.
This website is no longer maintained. I am ooking for replacement.
copy the string from “d=” to “&cl=”, namely “MlqUzlcZFdHetSQtyml5oHyt9RwVjZrsGbvyaRpMwgU” in this case to config.yml.
secret/index.html: decrypt the page use password
ykliu and save the page locally. Choose your password, copy and paste the HTML into the input textbox, and download the page. Replace secret/index.html with the HTML file you downloaded. Now you have an encrypted page only you can use to encrypt your other pages!
add propertyand download the google authentication file, put in under the root of your repo. A few days later, you should be able to see your website in google search by searching
site:your-site-name.github.io(no space in between).
After that, you should be able to enjoy your blogging!