Skip to content
Branch: dev
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
s
 
 
 
 
t
 
 
tt
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

This project is the source code for http://bobby-tables.com/, plus the Perl code that converts it from Markdown format into HTML and uploads it to the server.

Repository layout

  • s/
    • page bodies in Markdown format
  • tt/
    • templates in Template::Toolkit format
  • static/
    • images and styles
  • t/
    • tests
  • build/ (Not stored)
    • output

Requirements

GNU bash, make, gettext-runtime, gettext-tools.

Perl and additional CPAN modules.

For building:

  • File::Slurp
  • Markdent
  • Template

For testing:

  • Test::HTML::Tidy5

Alternatively a Dockerfile is provided which can run the necessary make tasks in a container.

docker build -t bobby-tables .                      # Builds the container
docker run --rm -v $PWD:/app bobby-tables           # Builds the site to the build/ directory
docker run --rm -v $PWD:/app bobby-tables make test # Runs the tests

Contributing page content

  1. Modify templates or page bodies. New pages have to be registered in the file crank.
  2. Run make to build the site and inspect the result in the build directory.
  3. Run make test to check for HTML errors.
  4. Commit/publish changes, see s/index.md.
You can’t perform that action at this time.