This is the repository including all source codes of https://skywalking.apache.org
.
This site was compiled using Hugo.
- Install hugo
- Run
npm install
to install the required libraries. - Pull this repo into your local environment, and run
hugo server
at the root folder, you can see the site preview from http://localhost:1313 - To generate the static website, run
npm run build
for the whole website. Runnpm run build-with-docs
if you want to build the project documentations.
This guide will guide you on how to contribute to the site.
This site uses Hugo to organize and manage content with the following sections are available:
Located at content/_index.html
。
The data of documentation link is located in data/docs.yml
and formated as YAML
.
Update the config file everytime in order that a new documentation version will be available searched by algolia.
Located at content/events
. If you don't want to create a new blog, you need to create a new subdirectory under this directory. Here is a sample event below.
---
title: This is a title
date: 2020-04-28
author: Author
description: This is description.
# endDate: 2021-04-24T23:59:59
# startDate: 2021-04-22T00:00:00
# buttonText: Go
# img: /images/skywalking_200x200.png
---
Content
If you want to display the event in the bottom right popover, you can configure the parameter endDate
. The parameters are as follows.
Parameter | Description | Required | Default |
---|---|---|---|
endDate | End date | true | - |
startDate | Start date | false | Current time |
buttonText | Button text | false | Read more |
img | The illustration | false | /images/skywalking_200x200.png |
Located at content/blog
. If you don't want to create a new blog, you need to create a new subdirectory under this directory. Here is a sample blog below.
---
title: This is a title
date: 2020-04-28
author: Author
description: This is description.
---
Content
The data of release is located in data/releases.yml
and formated as YAML
.
The data of docker image is located in data/dockerImages.yml
and formated as YAML
.
This is a single page located at content/team/_index.md
.
Located at content/zh
. If you don't want to create a new blog, you need to create a new subdirectory under this directory. Here is a sample blog below.
---
title: 博客标题
date: 2020-04-28
author: 作者姓名
description: 博客摘要
---
博客正文。
All user information are in /data/homepage.yml
. Users are encouraged to add themselves to this page.
Configure in the config.toml
file.
The website configuration file located at config.toml
.
The images within the blogs, events and 中文博客 should keep at the same folder as the blog file, and you should reference that with the relative path.