坚果云Markdown学校为每个研究者提供一个空间，用于存放个人学术主页，但只能是静态页面。搜了一下，没找到自己满意的模板。后来就想，用Markdown编辑好，再转换成html。事实上，这样做还有一个好处，主页可以在不同设备上显示得很好。动手弄了一个，效果还不错，欢迎围观：Qiankun SU at INP-ENSEEIHT.
1. 使用Python
使用pypandoc，示例代码如下：
#!/usr/bin/env python# -*- coding: utf-8 -*- import pypandoc # With an input file: it will infer the input format from the filenameoutput = pypandoc.convert_file(‘index.md’, ‘html’, outputfile=’index-2.html’)
这样做，只是简单地将Markdown转换成html，我的Markdown文档包含一些法语字符，不能正常显示，需要手动在html文件指定字符编码，即在html文件头部添加如下一行：
encoding = ”
2. 使用命令行
直接在命令行使用pandoc命令，使用-s选项为输出文档添加header和footer，举例如下：
# An example pandoc -f Markdown index.md -t html -Ss > index.html # Parameters-f formatSpecify input format -t formatSpecify output format -S, –smartProduce typographically correct output, converting straight quotes to curly quotes, — to em-dashes, — to en-dashes, and … to ellipses. Nonbreaking spaces are inserted after certain abbreviations, such as “Mr.” -s, –standaloneProduce output with an appropriate header and footer (e.g. a standalone HTML, LaTeX, TEI, or RTF file, not a fragment). This option is set automatically for pdf, epub, epub3, fb2, docx, and odt output.
这样就会在生成的html文档添加如下内容：
….
再自己手动添加title和icon，举例如下：
3. 转换bibtex
比如我一篇论文的bibtex如下：
@INPROCEEDINGS{su2015xor, author={Q. Su and K. Jaffres-Runser and G. Jakllari and C. Poulliat}, booktitle={2015 IEEE/CIC International Conference on Communications in China (ICCC)}, title={XOR network coding for data mule delay tolerant networks}, year={2015}, pages={1-6}, keywords={Base stations;Delays;Network coding;Protocols;TV;Throughput;Urban areas;Delay tolerant networks;XOR;data mules;network coding;village communication networks}, doi={10.1109/ICCChina.2015.7448634}, month={Nov},}
用上述的方法转换得到的html，得到的是一行，可读性差。使用hard_line_breaks选项，把段落内的newlines转换成换行，而不是空格，举例如下：
pandoc -f Markdown+hard_line_breaks MSWiM16.md -t html -Ss > MSWiM16.html # hard_line_breaksExtension: hard_line_breaksCauses all newlines within a paragraph to be interpreted as hard line breaks instead of spaces.
4. 上传到服务器
把做好的html打包，用scp上传到服务器，举例如下：
qsu@pc-irt18:~/Téléchargements$ scp su_homepage.tar.gz qsu@su.perso.enseeiht.fr:/var/www/su.persoqsu@su.perso.enseeiht.fr’s password: su_homepage.tar.gz 100% 9475KB 9.3MB/s 00:00
登录到服务器，解压就可以了，举例如下：
ssh su.perso.enseeiht.fr
至此，一个简洁的个人学术主页就有了:-)
