yegle / userpages

source for siongui.github.io

How to Develope

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

Development Environment: Ubuntu 14.10

First-time Setup

1. Install git, pip, and virtualenv:

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

2. Create and enter Python virtual environment: This step is optional, if you get error messages like No module named scss when you run make command, DO NOT use virtual Python environment and ignore this step.

$ cd
$ mkdir dev
$ virtualenv ~/dev/
$ cd ~/dev/
$ source bin/activate

3. git clone source code:

$ cd ~/dev/
$ git clone https://github.com/siongui/userpages.git

4. Install Python tools:

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

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

$ cd ~/dev/userpages/
$ make download

6. Generate CSS file:

$ cd ~/dev/userpages/
$ make scss

If you get error messages like No module named scss when you run make scss, DO NOT use virtualenv.

Daily Development

# enter virtual Python environment (optional).
# Ignore this step if you get error with make command.
$ cd ~/dev/
$ source bin/activate
# start edit and develope
$ cd ~/dev/userpages/
# 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

Online reStructuredText editor

edit on Github link:

pelican-edit-url

reStructuredText:

reStructuredText Markup Specification

reStructuredText简明教程

轻量级标记语言

reStructuredText 简明教程

rst2html:

How can I get rst2html.py to include the CSS for syntax highlighting?

Hottest 'rst2html.py' Answers - Stack Overflow

html4css1.css

rst2html stylesheet:

Writing HTML (CSS) Stylesheets for Docutils

rst2html css:

Documentation: Create GitHub like styled html doc file with rst2html

marianoguerra/rst2html5

How to render reStructuredText documents with latest docutils on Ubuntu 12.04 LTS

[rsST] 修改 rst2html highlight style

Docutils使用方式 (Google cache)

restructuredtext center text:

Best way to align center a paragraph with RestructuredText?

Bootstrap image trigger modal:

Can I use an image to trigger a modal window in Bootstrap?

Bootstrap Image trigger modal example code

Image Hover:

iHover (src)

bootstrap image hover overlay with icon