Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Use Git to clone the roller-website repo, for example:

    git clone https://gitbox.apache.org/repos/asf/logging-site.git

  2. Make sure you are on the asf-staging branch:

    cd logging-site
    git checkout asf-staging

  3. Make your changes to Markdowna (.md) and FreeMarker (.ftl) files under the source directory.

  4. Generate the website via Maven. Running mvn install will generate the website into the content directory.

    cd sources
    mvn install

    You can then view them in your browser by opening content/index.html. Or alternatively, run mvn jbake:inline so you can view the website locally at http://localhost:8080

  5. Once the site looks good, commit your changes and preview them in the staging environment.

    git add *
    git commit -m "my wonderful changes" .

    git push origin asf-staging

  6. Pushing your changes will cause the ASF website infrastructure will pick up your changes and publish them to the logging.staged.apache.org web site.

  7. Once the changes have been verified checkout the asf-site branch and update the asf-site branch to include your changes.

    Code Block
    git checkout asf-site 
    git rebase asf-staging


  8. Publish the site 

    Code Block
    git push origin asf-site


  9. The changes to the site should be published shortly. 
  10. Prepare asf-staging for the next update

    Code Block
    git checkout asf-staging 
    git rebase asf-site
    git push origin asf-staging


Updating Logging Services Project Web Sites

...