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/pali-chanting.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

Auto-deploy by Travis CI

See¹.

Daily Development

# start edit and develope
$ cd ~/dev/YOUR_REPO/
# If something changes, re-generate the website:
$ make html
# start dev server
$ make serve
# 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↩