Google Git
Sign in
apache / velocity-site / da274c180dfd31fb61ae2abebab9ebb5f052eec2
commitda274c180dfd31fb61ae2abebab9ebb5f052eec2[log] [tgz]
authorClaude Brisson <claude@renegat.net>Mon Oct 21 18:23:31 2024 +0200
committerClaude Brisson <claude@renegat.net>Mon Oct 21 18:23:31 2024 +0200
tree39e2c7a55c6f79404aceb37ee214dbb4c973e80b
parent72bca7a3b7a913bb2a29d509f6119ed3c489e7c3 [diff]
Prepare 2.4.1 pages binding and doap
8 files changed
tree: 39e2c7a55c6f79404aceb37ee214dbb4c973e80b
  1. builder/
  2. site/
  3. src/
  4. .asf.yaml
  5. LICENSE
  6. NOTICE
  7. README.md
README.md

Note: the branch trunk is obsolete. Please use the main branch.

The Apache Velocity Project

dev@velocity.apache.org

The Apache Velocity Site

Introduction

The Apache Velocity Site is what you get when you visit http://velocity.apache.org/ (our homepage). It is the envelope site for all Apache Velocity sub projects.

In short: This Git repository is only interesting for you if you

a) want to re-create the Apache Velocity site on your local computer or intranet.

b) are an Apache Velocity committer/contributor and want to update the site.

Building the Site

Apache Velocity uses Apache Content Management System to build the site. The whole process of buiding the site is automated with a Docker based build script.

The required software you need is:

*) Git - to checkout and commit *) Docker - builder.sh uses it to run Apache CMS that generates HTML out of the Markdown files *) A text editor - to edit the Markdown files *) A web browser - to review the changes in the generated HTML files

Steps:

  1. Create a parent folder for the local Git clones

export VELOCITY_PARENT_FOLDER=“/path/to/velocity” mkdir -p $VELOCITY_PARENT_FOLDER cd $VELOCITY_PARENT_FOLDER

  1. Clone the GitHub repository for editing the Markdown files

git clone --single-branch --branch main git@github.com:[YOUR_GITHUB_ID]/velocity-site.git

  1. Edit the Markdown files

$VELOCITY_PARENT_FOLDER/velocity-site edit src/content/[FILE].mdtext

  1. Build the HTML files

./builder/bin/builder.sh

  1. Check the generated HTML locally

open localhost:8000 in your favorite web browser and navigate around to review your changes

  1. Commit your changes

cd $VELOCITY_PARENT_FOLDER/velocity-site git commit -a -m “Some message explaining your changes” git push

  1. Create a Pull Request in GitHub UI

Questions and contact

If you have questions about the Apache Velocity Site building process, please ask the Velocity developers on the Velocity Developers mailing list at dev@velocity.apache.org.