commit | 728a45aef35d793e72a79718d8f464a17db9e69d | [log] [tgz] |
---|---|---|
author | Dale LaBossiere <dlaboss@us.ibm.com> | Wed Nov 01 22:25:58 2017 -0400 |
committer | Dale LaBossiere <dlaboss@us.ibm.com> | Wed Nov 01 22:25:58 2017 -0400 |
tree | df3831a7a168ef860bf0b95acba898930205fada | |
parent | feb8457e42752a334a9078ebc2e69a4bd3dcae18 [diff] |
[WIP] changes for Edgent PR-309 (maven) - rework downloads page for changes is distributing samples/binaries - rework Getting Started Guide, preserve old as old-edgent-getting-started and link to it - Add Quickstart with Edgent Samples, rename samples page to old-samples and link to it from old getting started only - Add Edgent Application Development - update FAQ - update LHS Navigation sidebar (adjust for above) - update Top navigation bar (adjust for above)
http://edgent.incubator.apache.org/
This procedure was borrowed in part from the Apache Apex site except we use Jekyll.
The master
branch of this repo contains the source files that are used to generate the HTML that ultimately gets pushed to the incubator 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.
If you would like to make a change to the site:
master
If you are a committer, do the following:
build.sh
from the master branch directory (requires Jekyll). This checks out and updates the asf-site
branch with a new commit of the build from the current branch.asf-site
branch. Simply push this branch to the asf remote with git push origin asf-site
and the site will automatically be updated within seconds.Note: If you want to try out the website locally on the asf-site branch before you push, you can do so with jekyll serve -d content --skip-initial-build
and point your browser to http://localhost:4000
.
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:
##
in order to have them be automatically added to the Table of Contents##
to ####
.`
```
, and if applicable, specify the language for syntax highlightingsite
directory: cd site
jekyll serve
http://localhost:4000