Dubbo Official Website

This project keeps all sources used for building up Dubbo official website which's served at https://dubbo.apache.org.

Overview

The Apache Dubbo docs are built using Hugo with the Docsy theme.

This project contains the markdown source files of the Dubbo documentation.

Pre-requisites

• Hugo extended version
• Go
• Node.js

Environment setup

You can directly start working on this repository even from your browser by just clicking on the following button

Or, you can follow the manual steps given below.

1. Ensure pre-requisites are installed
2. Clone this repository

git clone https://github.com/apache/dubbo-website.git

3. Install PostCSS required by Docsy by running the following commands from the root directory of your project:

$ npm install --save-dev autoprefixer
$ npm install -D postcss
$ npm install --save-dev postcss-cli

Run server locally

1. Clear up your local module cache

hugo mod clean

2. Start the server

hugo server --disableFastRender
# If you get stuck with 'hugo: downloading modules …' after running this command, please try to set GOPROXY by running `export GOPROXY="https://goproxy.cn|https://proxy.golang.com.cn"` and try again.

3. Navigate to http://localhost:1313

Update docs

1. Create new branch
2. Commit and push changes to content
3. Submit pull request to master branch
4. Staging site will automatically get created and linked to PR to review and test