This is the content of my super blog post.
When I come across to know that Github can host personal static blog (How?), I decide to build my own. Jekyll, a simple static site generator, first comes to my sight. Its function is cool, but it's written in Ruby. So I am wondering whether there is a Python one, as we all know
Life is short, use Python. ;-)
Finally I get to Pelican. According to instruction, it's easy to setup a static blog. There are a lot themes to choose. If you want to modify a theme template, some programming knowledge is needed. Learn some CSS skills to make your blog more pretty.
How to write articles with Pelican, my answer is Markdown. It is a plain text formatting syntax and also a tool to convert Markdown files to HTML webpage. The syntax is friendly to people even not programmer.
For example, just use > to get reference style. Type this
> Just because I'm hurting
> Doesn't mean I'm hurt
> Doesn't mean I didn't get what I derserved
> No better and no worse
> I just got lost!
you will get the following
Just because I'm hurting
Doesn't mean I'm hurt
Doesn't mean I didn't get what I derserved
No better and no worse
I just got lost!
As I am now doing some research, math formula will be frequently used in article.
The popular solution is MathJax.
However, there are some conflicts between Markdown and MathJaxas. Markdown processes article before MathJax,
and it deals with _ as italic sign which represents subscript in MathJax.
A Pelican plugin render_math can help.
Since most open projects are developed and maitained by only a few people. It's not tested on all platform.
To make the plugin work and suit my need, I have paid a lot efforts.
Until now, I can write posts. You see it seems easy, but it's not. Actually, far more issues have not been solved.
An crutial one is how to combine Matlab code with Markdown. One way is to use IPython notebook and Pymatbridge
to call Matlab and get output result. You can image the process will be frustrating. When bugs occur,
I get no answers from Google, since the plugin is new. After I try all methods, it suddenly works and I don't know why. =.=
Theory is when you know everything but nothing works
Practice is when everything works but no one knows why
In my situation, theory and practice are combined: nothing works and no one knows why.
Another way is just to use Matlab, save the output and write some scripts to convert the .m files to .md files.
This one should be more convenient. Not done yet.
Anyway, let's just begin. A list of required elements is summarized as below:
- Python
- Pelican
- Markdown
- CSS
- MathJax
A basic tutorial and quick reference of MathJax
Um's Verrecken Anders = Different At All Cost = 生命不息，折腾不止