run npm run build for doing the following steps automatically:
then if you want to debug, just run
# serve with hot reload at localhost:8080
npm run dev
# build for production with minification
npm run build
Remember, only the changes of site/src can be logged by Git. All changes in the target folder will be ignored by Git.
If you add -Dscm-branch=asf-staging in your command, then the website will be published to https://iotdb.staged.apache.org
If you get an error on your MacOS:
gyp: No Xcode or CLT version detected!
Then, install CommandLine of Xcode: sudo xcode-select --install.
If you have installed and the error still occurs, then sudo xcode-select --reset
- All mds will be compiled into html, REDEME.md will be compiled into index.html, and xx.md will be compiled into xx.html
- The tags in .md must have a beginning and an end. For example, <tr> must have a </ tr> corresponding to it, and it is strictly corresponding; if you need to insert tags in the document, such as List <String>, you can add this into the code block, You can also add \ before the two angle brackets, such as <\String\>
- Tags cannot be cross-nested, such as <p> <center></p></center> This is not allowed
- The first-level title of the article is the title of the sidebar of the document, so the largest chapter title of the document is not needed
Place the components in the .vuepress / components directory
Use <component/> directly in the md file
Tutorial on the use of vue componentshttps://cn.vuejs.org/v2/guide/components.html
- Only modify existing documents: only need to modify the content of the document, do not modify the file name (change the file name to config.js)
- Adding documents: Put the added documents in the directory where you put them together, record the link path of the directory, and modify it in .vuepress / config.js
Head, base, title, description, etc. need hardly be modified
See specific configuration information https://www.vuepress.cn/config/
head,base,title,description
head: [
["meta", {name: "Description", content: "Apache IoTDB: Time Series Database for IoT"}],
["meta", {name: "Keywords", content: "TSDB, time series, time series database, IoTDB, IoT database, IoT data management,时序数据库, 时间序列管理, IoTDB, 物联网数据库, 实时数据库, 物联网数据管理, 物联网数据"}],
["meta", {name: "baidu-site-verification", content: "wfKETzB3OT"}],
["meta", {name: "google-site-verification", content: "mZWAoRY0yj_HAr-s47zHCGHzx5Ju-RVm5wDbPnwQYFo"}],
],Additional tags that need to be injected into the HTML <head> of the current page, each tag can be specified in the format of [tagName, {attrName: attrValue}, innerHTML?]
base:The base path of the deployment site. If you want to deploy your site to a sub-path, you will need to set it.
title:The title of the website, it will be used as the prefix of all page titles. At the same time, under the default theme, it will be displayed on the navigation bar (navbar)
description:The description of the website, which will be rendered into the HTML of the current page with the <meta> tag.
See specific configuration information https://www.vuepress.cn/config/
locales: {
'/': {
lang: 'en-US',
title: ' ',
description: ' '
},
'/zh/': {
lang: 'zh-CN',
title: ' ',
description: ' '
}
},Represents / jumps English links, / zh / jumps Chinese links.
The storage structure of the file is as follows.
docs
├─ Userguide
├─ SystemDesign
├─ Download
│ └─ README.md
├─ etc.
└─ zh
├─ Userguide
├─ SystemDesign
└─ Download
└─ README.md
├─ etc.
nav indicates the top navigation bar. Modify nav and pay attention to the Chinese or English version you modify.
Where title represents the title of one of the nav, and items is the drop-down list
nav: [
{
text: 'Document',
items: [
{ text: 'In progress', link: '/UserGuide/master/0-Get Started/1-QuickStart' },
{ text: 'V0.9.x', link: '/UserGuide/V0.9.x/0-Get Started/1-QuickStart' },
{ text: 'V0.8.x', link: '/UserGuide/V0.8.x/0-Get Started/1-QuickStart'},
]
},The first one is a jump link, and children is the jump link that supplements this document
The total link is the domain name of the site + the specified language version (/ or / zh /) + the link of the sidebar + the link of the children
For other sidebar property configuration, see vuepress tutorialhttps://vuepress.vuejs.org/theme/default-theme-config.html#sidebar
If you find it difficult to find in progress, directly ctrl + F search /UserGuide/master/ Jump to that piece, Chinese is /zh/UserGuide/master/
sidebar: {
'/UserGuide/V0.8.x/': [
{
title:'User Guide(V0.8.x)',
collapsable: false,
},
{
title: '0-Get Started',
children: [
'0-Get Started/1-QuickStart',
'0-Get Started/2-Frequently asked questions',
'0-Get Started/3-Publication'
]
},