Pages

▼

Monday, 26 May 2014

在linux vps上，搭建基于python的静态博客程序-mkdocs

pip install mkdocs
mkdocs -h
显示：
mkdocs [help|new|build|serve] {options}

mkdocs new mkdocs-site (此命令会在当前目录下，生成mkdocs-site目录）
cd mkdocs-site

as3:~/mkdocs-site# ls
docs  mkdocs.yml 
as3:~/mkdocs-site# mkdocs build (这个就是生成/更新静态网站的命令）
as3:~/mkdocs-site# ls
docs  mkdocs.yml  site （新出现了site目录）
as3:~/mkdocs-site# cd site
as3:~/mkdocs-site/site# ls
css  fonts  img  index.html  js
（可见~/mkdocs-site/site/就是静态网站的根目录）
as3:~/mkdocs-site/site# nohup Rwebserver 45318 > /dev/null &
访问http://as3.brite.biz:45318/即可看到网站效果。

发贴方法：
as3:~/mkdocs-site/site# cd ../docs
as3:~/mkdocs-site/docs# nano test1.md
格式为：
# 测试1

这是测试1.

然后，
as3:~/mkdocs-site/docs# cd ..
as3:~/mkdocs-site# mkdocs build  (这个就是生成/更新静态网站的命令）

演示站点：http://as3.brite.biz:45318/，http://md.brite.biz.st

http://www.mkdocs.org/ （程序作者用此程序搭建的网站）
项目地址：https://github.com/tomchristie/mkdocs/
https://github.com/mkdocs/mkdocs/
-----------------------------------------------------------

一个示范网站的源码https://github.com/riker-rs/website
----------------

https://zjdoc-docguide.readthedocs.io/zh_CN/latest/
----------------

Welcome to MkDocs

This is a test site hosted on GitLab Pages. You can browse its source code, fork it and start using it on your projects.

For full documentation visit mkdocs.org.

Commands

  • mkdocs new [dir-name] - Create a new project.
  • mkdocs serve - Start the live-reloading docs server.
  • mkdocs build - Build the documentation site.
  • mkdocs help - Print this help message.

Project layout

mkdocs.yml    # The configuration file.
docs/
    index.md  # The documentation homepage.
    ...       # Other markdown pages, images and other files.

from https://pages.gitlab.io/mkdocs/

at