liuning0820 / liuning0820.github.io

"对刘谈心" 微信公众号素材，个人博客(blog)，文档即代码(document as code)。

Personal Blog

• Run The Site Locally
  • Run The Site In Docker
  • Run with docker-compose
• Hosted By GitHub Pages
• Hosted by Netlify
• Supporting Technologies
  • Jekyll Collection
  • Jekyll Themes
  • jekyll-sitemap
  • GitHub Page Support
  • HTML Presentations - reveal.js
    • PDF Export
• SEO
  • Sitemaps
  • robots.txt
  • Google Analytics 数据增长
  • Bing 网站管理员
• References
  • 同类型博客

Run The Site Locally

gem install jekyll bundler
# Run 'bundle install' to install missing gems added in the Gemfile.
bundle install
jekyll -v
# jekyll serve
bundle exec jekyll serve

Then browse to http://localhost:4000

Run The Site In Docker

Refer https://medium.com/windmill-engineering/how-i-built-a-simple-static-jekyll-site-without-installing-ruby-a-rant-b7e87fb123d0

docker build -t my-jekyll-env -f Dockerfile .
docker run --name my-jekyll-env --mount type=bind,source=$(pwd),target=/src -p 4000:4000 -it my-jekyll-env

Run with docker-compose

docker compose build
docker compose up

navigate to 127.0.0.1:4000

Hosted By GitHub Pages

Hosted at https://liuning0820.github.io/

Hosted by Netlify

Netlify is a cloud computing company that offers hosting and serverless backend services for static websites. It features continuous deployment from Git across a global application delivery network, serverless form handling, support for AWS Lambda functions, and full integration with Let's Encrypt.

The site dashboard can be accessed Site Dashboard

Deployed at https://liuning0820.netlify.com/

Supporting Technologies

• Jekyll
• Jekyll Themes
• HTML Proofer - Validates HTML links, used in the CI/CD pipeline. Installed as a Ruby gem.
• HTML Proofer Usage
• Markdown Spellcheck - Runs spell check in the CI/CD pipeline. Installed via Node.js npm.
• Github Page
• HTML Presentations - reveal.js
• Search Feature - lunr.js

Jekyll Collection

Implement Jekyll Collections

The collection should start with a underscore.

Jekyll Themes

Your Pages site will use the layout and styles from the Jekyll theme you have selected in your repository settings. The name of this theme is saved in the Jekyll _config.yml configuration file.

jekyll-sitemap

silently generate a sitemap.xml for your jekyll site.

https://liuning0820.github.io/sitemap.xml

GitHub Page Support

Having trouble with Pages? Check out the documentation and it will help you sort it out.

HTML Presentations - reveal.js

PDF Export

ex. http://localhost:4000/ex_presentations/2021-05_a_clean_dev_env/?print-pdf#/ ex. https://liuning0820.github.io/ex_presentations/2021-05_a_clean_dev_env/?print-pdf#/

SEO

Sitemaps

The Sitemaps protocol allows a webmaster to inform search engines about URLs on a website that are available for crawling. refer

robots.txt

robots.txt可以告诉搜索引擎您网站的哪些页面可以被抓取，哪些页面不可以被抓取。

User-agent: *
Disallow: /

Google Analytics 数据增长

统计你的网站的访问量等相关数据。

Google Analytics

Bing 网站管理员

https://www.bing.com/webmaster/home/dashboard

References

• Travis CI
• Jekyll
• Hugo-gitlab-page

同类型博客

• https://yihui.name
• home-assistant

liuning0820.github.io's Issues

Test GitHub API Comment.

兼容iPhone及其他移动设备正常浏览的响应式 Web

Change css from fixed px to percentage.
ex. margin-left: 100px; to margin-left: 15%;

同一篇文章提供中英文双语版本

As an global reader, I may want to read the article in Chinese version or in English version.