Apache Shiro Website

Clone this repo:
  1. 8acbbcd Merge pull request #65 from Amitsharma0201/master by François Papon · 12 hours ago master
  2. 166acb9 Update realm.md.vtl by Amitsharma0201 · 12 hours ago
  3. 10bbbf3 .asf.yaml needs to be included in the asf-site branch in order for the files to be published by Brian Demers · 6 weeks ago
  4. c78ead6 ignore new .asf.yaml when building the site by Brian Demers · 6 weeks ago
  5. eea3bb5 adding "publish" branch to .asf.yaml by Brian Demers · 6 weeks ago

Apache Shiro Website Overview

The Apache Shiro website is a static content website accessible at http://shiro.apache.org

Site content is authored as Markdown and HTML files. These files are scanned by a tool that applies a page template to each file's contents as necessary, and the rendered static .html files are output to a dest_dir directory.

To publish the site commit changes to the asf-site branch of this repository. ASF infrastructure will see the commit and automatically push the changes to the ASF's production webservers.

Generating and Publishing

The tool used to generate the static content is SCMS. Once scms is installed and in your $PATH, generating and publishing the site on the command line is easy.

The following example assumes you have commit permissions to the apache/shiro-site repository, typically because your are an Apache Shiro project committer:

# clone both repo branches `asf-site` and `master`
git clone https://github.com/apache/shiro-site -b asf-site shiro-site-publish
git clone https://github.com/apache/shiro-site

# build the site
cd shiro-site
scms . ../shiro-site-publish
# Open up the local ../shiro-site-publish/index.html file in your web browser.  Ensure the changes reflect what you want. 

# These next commands will publish changes to live ASF web servers.  Be confident the changes are what you want:
cd ../shiro-site-publish
git add .
git commit -am "my change description"
git push origin asf-site

# It should only take a few minutes until the files are live