From f70285c9f3f4ad7fa55af96d6df3838336148d74 Mon Sep 17 00:00:00 2001 From: huxiguo Date: Fri, 11 Feb 2022 20:15:44 +0800 Subject: [PATCH] brpc website 1.0 update readme --- README.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 52 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index afe06b21..5109ca53 100755 --- a/README.md +++ b/README.md @@ -1,7 +1,55 @@ -# brpc Website -The Website of brpc (http://brpc.apache.org) is using the apache.org template from [Apache Website Template](https://github.com/apache/apache-website-template). +# bRPC Official Website + +This project keeps all sources used for building up bRPC official website which's served at https://brpc.apache.org. + +## Overview + +The Apache bRPC docs are built using [Hugo](https://gohugo.io/) with the [Docsy](https://docsy.dev) theme. +This project contains the hugo project, markdown files, and theme configurations. + +## Pre-requisites + +- [Hugo extended version](https://gohugo.io/getting-started/installing) +- [Node.js](https://nodejs.org/en/) + +## Environment setup + +Install pre-requisites +```sh +$ sudo apt install npm +$ npm install +``` + +## Run local server + + +1. Clone this repository +```sh +git clone https://github.com/apache/incubator-brpc-website.git +``` +2. Change to root directory: +```sh +cd incubator-brpc-website +``` +3. Run +```sh +hugo server +``` +4. Navigate to `http://localhost:1313` + +5. If you want to generate the static pages, just run +```sh +hugo +``` # Note for PR -As this website is using the [gitpubsub](https://www.apache.org/dev/project-site.html) and we use Jekyll to generate the site. + We choose master branch to hold all the site source change and asf-site for apache github website. -Please sent your PR to the master branch instead of asf-site. \ No newline at end of file +Please sent your PR to the master branch instead of asf-site. + +## Update docs +1. Create new branch +2. Commit and push changes to content +3. Submit pull request to **master** branch +4. Generate static pagas and Submit pull request to **asf-site** branch +5. Staging site will automatically get created and linked to PR to review and test \ No newline at end of file