建站手册

简介

本文档介绍几种常用的网站建设工具。

工具汇总

wordpress

mkdocs

pip install mkdocs

• 修改底部的文字：

  /usr/lib/python2.7/site-packages/mkdocs/themes/mkdocs/base.html
  可以增加备案号

Docusaurus

https://github.com/demopark/docusaurus-docs-Zh_CN

• 安装node

 git clone https://github.com/facebook/Docusaurus.git
 cd Docusaurus
 npm install --global docusaurus-init
 docusaurus-init

• 在 Docusaurus 目录下，将 docs-examples-from-docusaurus 改名 docs，进入 website 目录，将blog-examples-from-docusaurus 改名为 blog

所有的文档文件都应该作为 .md 文件放在 docs 文件夹中。 任何博客文章都应该在 blog 文件夹中。

博客帖子的格式必须为 yyyy-mm-dd-your-file-name.md

将您的文档以 .md 文件的形式添加到 /docs 文件夹中，并确保每个文件都有正确的header。 最简单的标题如下，其中 id 是链接名称（例如 docs/intro.html），title 当然是浏览器页面的标题。

---

id: intro title: 入门

---

这是我的 新文件内容 ...

将零个或多个文档添加到 sidebars.json 文件，以便您的文档在侧边栏中呈现，如果您想要显示它们。

如果您不将文档添加到 sidebars.json 文件中，那么文档依然被渲染，但只能从其他文档链接到该文档，并使用已知的URL进行访问。

• 修改 website/siteConfig.js 文件来配置网站，按照 website/siteConfig.js 的 文档 指引。
• 创建任何的 自定义页面 和/或 自定义 website/core/Footer.js 文件来为你的网站提供页脚。
• 将网站资源（如图像）放在 website/static/ 文件夹中。
• 运行该网站以查看更改的结果。 cd website yarn run start # 或 npm run start 浏览 http://localhost:3000

编译静态文件，并托管到http

进入：website目录，执行如下命令： npm run build

进入build/test-site目录下的所有文件到apache： cp -r ./build/test-site/* /var/www/html/

docsite

docsify

mdwiki

gitbook

mkdir /home/gitbook cd /home/gitbook

npm install gitbook-cli -g

gitbook -V gitbook init gitbook serve

jspwiki

下载jdk，配置环境变量 下载tomcat并启动 下载jspwiki放到tocmat发布目录 访问：http://localhost:8080/JSPWiki

hugo

安装

下载二进制包，直接解压 注意还有：extend版本，表示支持theme要使用的一些特殊的特性

创建项目

hugo new site testsite

创建页面

hugo new first.md