/dubbo-website

Apache Dubbo documents

Primary LanguageHTMLApache License 2.0Apache-2.0

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 hugo project, markdown files, and theme configurations.

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. Change to root directory:
cd dubbo-website
  1. Add Docsy submodule:
git submodule add https://github.com/google/docsy.git themes/docsy
  1. Update submodules:
git submodule update --init --recursive
  1. Install npm packages:
npm install

Run local server

  1. Run
hugo server --disableFastRender
  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