0
Watch
0
Star
0
Fork
0
Issue

Mirror of Apache Quarks site (Incubating)

ckadner
ckadner
pushedAt 5 years ago

ckadner/apache-bahir-website-old

Apache Bahir web site

Location

http://bahir.apache.org/

How it works

This procedure was borrowed in part from the Apache Quarks web site using Jekyll.

The master branch of this repo contains the source files that are used to generate the HTML that ultimately gets pushed to the web site. The asf-site branch is where the actual generated files are stored. Note that this branch must contain exactly one folder called content, and so has been checked out as an orphan branch with its own commit history apart from the master branch. See the Contributing section below.

Through a gitpubsub mechanism on the apache.org server, files are taken from the asf-site branch and pushed to the live server.

Contributing

If you would like to make a change to the site:

  1. Fork the GitHub mirror
  2. Create a new branch from master
  3. Add commit(s) to your branch
  4. Test your changes locally (see the Developing section)
  5. Open a pull request in the GitHub mirror
  6. A committer will merge your changes if all is good

Style Guide

The website utilizes Markdown as the basis for website content. This cheatsheet may prove useful.

In order to ensure a consistent user experience, these guidelines should be followed:

  1. For all headers, use sentence-style capitalization
    • Capitalize the first word of the title/header or subtitle/subheader
    • Capitalize any proper nouns and certain other types of words (e.g., programming terms)
    • Use lowercase letters for everything else
  2. Page headers should start at Level 2 using ## in order to have them be automatically added to the Table of Contents
  3. Do not skip header levels. For instance, do not jump from ## to ####.
  4. Use section headings as a way to separate large blocks of content and as reference markers in the Table of Contents
  5. Code references (e.g., to a Java class) should be placed in inline code blocks using a single backtick `
  6. For code blocks, use three backticks ```, and if applicable, specify the language for syntax highlighting
  7. Avoid using raw HTML tags. Use the equivalent Markdown syntax.
  8. Whitespaces
    • Use one whitespace between sentences.
    • Use one blank line between paragraphs for the best readability
    • Do not use leading whitespace, except for special cases, such as indenting within list items
    • Do not use trailing whitespace, except for the case where a line break is needed. In that case, end a line with two spaces.
  9. Use correct spelling and grammar, especially for references to other projects. For example, use GitHub, not Github.

Developing

  1. Make your changes under the site directory: cd site
  2. jekyll serve
  3. Point your browser to http://localhost:4000
ucloud ads