Apache Dubbo documents

Clone this repo:
  1. 673422f :memo: release add asc sig (#2931) by xiaosheng · 10 hours ago master
  2. 3b6fe90 Update general-knowledge.md (#2930) by Zaki · 6 days ago
  3. 3c65cee Updated footer CSS (#2929) by rashi arora · 6 days ago
  4. 7aa5c21 Update build_and_deploy.yml by Albumen Kevin · 8 days ago
  5. c51e17c Add kapa AI (#2925) by Albumen Kevin · 8 days ago

Dubbo Official Website

CI Status

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

Environment setup

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

Open in Gitpod

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
  1. 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
  1. 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.
  1. 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