Skip to content
Apache ServiceComb
HTML CSS Other
Branch: asf-site
Clone or download
Latest commit a72544b Aug 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_data Add a quick start case for mersher. Aug 9, 2019
_developers Keep polish the release_guide Apr 30, 2019
_docs Edit mersher quick start. Aug 14, 2019
_faqs 修改错误答案 Jul 11, 2019
_includes Fixed the broken link of servicecomb website footer Dec 13, 2018
_layouts removed about entry and useless files Sep 21, 2017
_pages Update release information for Java-Chassis 1.2.1 May 20, 2019
_posts Update the status of ServiceComb Pack project Aug 6, 2019
_release Update release information for Java-Chassis 1.2.1 May 20, 2019
_sass Update the Latest News Section Jun 22, 2018
_users
assets Edit mersher quick start. Aug 14, 2019
content
licenses SCB-366 Clean up the LICENSE and NOTICE files Mar 8, 2018
script Refresh website based on the latest community updates Nov 14, 2018
.gitignore Don't ignore the content directory in asf-site branch Dec 20, 2017
CNAME Create CNAME Jun 14, 2017
DISCLAIMER SCB-123 Add DISLAIMER file to ServiceComb git repo Jan 7, 2018
Gemfile Added the site files Jun 8, 2017
LICENSE SCB-366 Clean up the LICENSE and NOTICE files Mar 8, 2018
NOTICE
README.md SCB-519 Updated the README file Apr 27, 2018
Rakefile Added the site files Jun 8, 2017
_config.yml Updated the ServiceComb for the graducation Oct 21, 2018
banner.js Added the site files Jun 8, 2017

README.md

ServiceComb Website

The Web Site of ServiceComb is based on Minimal Mistakes Jekyll Theme.

NOTE for PR

As this website is using the gitpubsub and we use Jekyll to generate the site. We choose master branch to hold all the site source change and asf-site for apache gitpubsub. Please sent your PR to the master branch instead of asf-site.

How to run the site locally

  • Change to non-root user

  • Install Ruby and Gem

  • Install Jekyll and Bundler

    sudo gem install jekyll bundler

  • Clone the site files

    git clone https://github.com/apache/incubator-servicecomb-website.git

  • cd incubator-servicecomb-website

  • Install the gems with bundle

    sudo bundle install

  • Start the jekyll server

    sudo bundle exec jekyll server

  • Start web browser to access http://localhost:4000

Note that tested versions of the tools covered in this section are as following,

  • Ruby 2.3
  • Gem 2.7.6
  • Bundler 2.3

Multiple language support

The website supports English now and English is used as the default language.

Things to be cautious:

There are two language labels: en and cn.

  1. When you write a post, add the following front matters under the title(if you write an Chinese post):
    lang: cn
    ref: unique_post_ref_just_like_the_url
    And remember to add the prefix /cn to your permalink, e.g. before:
    permalink: /about/me/
    after:
    permalink: /cn/about/me/
    Besides, if contents of your post contains links to the Chinese version of pages, remember to add the prefix /cn before the link. e.g. /about/community/ becomes /cn/about/community/ Notes: English Posts do not need to add any prefixes as it's the default language.
  2. When you add items in _data/navigation.yml file, remember to add both English and Chinese version of that links.
  3. If you want to provide both English and Chinese versions of your bio in your blogs, add biocn property in _data/authors.yml.
  4. Posts of Chinese Language please put under the cn folder. It is just a good convention and won't affect what your posts suppose to be whether or not you obey this rule.

Add caption to image

Add the annotation {: .figure-caption} below the Image Caption line as follows:

![image alt text](image_path)
Image Caption
{: .figure-caption}
You can’t perform that action at this time.