How to Develope

Development Tool: Pelican (static site generator written in Python)

Development Environment: Ubuntu 22.04

First-time Setup

1. Install git and pip:

   $ sudo apt-get install git
   $ sudo apt-get install python-pip

2. Install language packages to add locale (English, Traditional Chinese, and Thai in this example):

   $ sudo apt-get install language-pack-en
   $ sudo apt-get install language-pack-zh-hant
   $ sudo apt-get install language-pack-th

3. git clone source code:

   $ cd
   $ mkdir dev
   $ cd ~/dev/
   $ git clone https://github.com/siongui/pelican-template.git YOUR_REPO

4. Install Python tools:

   $ cd ~/dev/YOUR_REPO/
   $ sudo pip install -r requirements.txt

5. Install Pelican i18n_subsites plugin and download normalize.css:

   $ cd ~/dev/YOUR_REPO/
   $ make download

6. Generate CSS file:

   $ cd ~/dev/YOUR_REPO/
   $ make scss

Daily Development

# start edit and develope
$ cd ~/dev/YOUR_REPO/
# re-generate the website and start dev server
$ make
# open your browser and preview the website at http://localhost:8000/

UNLICENSE

All works, including posts and code, of Siong-Ui Te are released in public domain. Please see UNLICENSE.

References

[1]	Deploy Website by Pelican, Travis CI, and GitHub Pages

[2]	JINJA_FILTERS in Settings — Pelican documentation Jinja custom filters documentation

[3]	淨土教觀學苑全球資訊網

[4]	GitHub Pages Deployment - Travis CI