https://github.com/apache/shiro-site
Apache Shiro Website
https://github.com/apache/shiro-site
apache shiro
Last synced: 6 months ago
JSON representation
Apache Shiro Website
- Host: GitHub
- URL: https://github.com/apache/shiro-site
- Owner: apache
- Created: 2016-07-19T07:00:09.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2025-04-09T19:49:12.000Z (6 months ago)
- Last Synced: 2025-04-10T11:59:16.032Z (6 months ago)
- Topics: apache, shiro
- Language: HTML
- Homepage: https://shiro.apache.org/
- Size: 74.8 MB
- Stars: 23
- Watchers: 10
- Forks: 191
- Open Issues: 2
-
Metadata Files:
- Readme: README.adoc
- Contributing: CONTRIBUTING.adoc
Awesome Lists containing this project
README
= Apache Shiro Website Overview
The Apache Shiro website is a static content website accessible at https://shiro.apache.org/.
Site content is authored as Markdown, Asciidoc and HTML files.
These files are parsed by the tool `jbake` and renders the content files using freemarker templates to static `.html` files.
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 https://jbake.org/[JBake].
JBake is used as a maven plugin, i.e. you do not need to have it in your `${PATH}`.
Generating and publishing the site on the command only takes a few maven and git commands.
Please carefully check the requirements outlined in link:CONTRIBUTING.adoc[].
The following example assumes you have commit permissions to the `apache/shiro-site` repository, typically because you are an Apache Shiro project committer:
[source,bash]
----
# clone both repo branches `asf-site` and `main`
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
mvn clean process-classes
# 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:
rsync -avP --delete --exclude .git target/website/. ../shiro-site-publish
cd ../shiro-site-publish
# Please check that you did not modify any of the following files:
# .asf.yaml
# .htaccess
# robots.txt
git add .
git commit -am "my change description"
git push origin asf-site
----
It should only take a few moments until the changes are live.