This static site generator is designed to build a static archive of questions and other metadata from the decomissioned Askbot-hosted ROS Answers and Gazebo Answers Q&A forums.
It is built using nanoc with questions exported as static markdown files.
Many questions from these sites were migrated to Robotics StackExchange but those that were not remain here. This project will also generate the redirect configuration to redirect migrated questions to their new home on Robotics StackExchange.
There is an Earthly build configuration for running the build in containers.
Content for ROS and Gazebo Answers are stored on separate content branches of this repository.
To populate content in your local worktree, use the +checkout target and specify ros or gazebo with the CONTENT build argument.
earthly +checkout --CONTENT=gazebo
Once content is checked out you can build the site with the +compile target.
After compilation is complete the generated site will be saved to the output directory locally.
earthly +compile
In order to test the full site configuration with redirect behavior and all, you can generate a container image configuring ASF httpd with the +server target.
earthly +server --CONTENT=gazebo
You can then run the created container image with your preferred container client: (docker, podman, etc)
docker run -p 80:80 gazebo-answers-httpd
It will then be visible at http://localhost
Alternatively, you can view the site with a local web server of your choice such as python's build in http server
pushd output; python3 -m http.server; popd
For local development without using Earthly you'll need:
Use the checkout_content.sh script to populate content.
./checkout_content.sh gazebo
bundle install
bundle exec nanoc
bundle exec nanoc view
The site will be available at http://localhost:3000