Build Instant Websites with Poole

Dmitri Popov

Productivity Sauce

Mar 28, 2012 GMT
Dmitri Popov

What do instant coffee and Poole have in common? Both can be used to get a result in seconds. Put a teaspoon or two of instant coffee in a cup, add hot water, stir, and enjoy. Generating a website with Pool is almost as fast and easy. But before you put Poole to some practical use, make sure that Python 2.5 or higher and the python-markdown package are installed on your machine. Pull Pool from the project's Mercurial repository:

hg clone ~/poole

Open the ~/.bashrc file in a text editor and add the following line to it:

export PATH=$PATH:~/poole

Create a directory for your website and switch to it:

mkdir ~/poolsite
cd ~/poolsite

Use the commands below to initialize the directory, generate a sample website, and launch Poole's built-in server: --init --build --serve

You can then see the freshly-baked website in all its glory by pointing your browser to

To add a new page to the sample website, create a Markdown text file in the ~/poolsite/input directory. If you want to include the page into the website's navigation menu, add the following header at the top of the text file (replace Page title with the actual name and specify the desired position in the menu by modifying the menu-position value).

title: Page title
menu-position: 0

Save the file with the md extension, and run the --build command to rebuild the website. Despite its simplicity, Poole is a rather flexible tool. For example, it uses a simple HTML template to generate pages, so you can easily control the final result by tweaking the template and the poole.css file in the input directory. For more tips and tricks on using Poole, visit the project's website.


  • command not found

    my first question is if it matters whre in the bashrc file we put the export line. then after i tried putting it at the beginning and at the top, after i create the directory and go to it and type th command "export PATH=$PATH:~/poole" it says command not found.
comments powered by Disqus
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters

Support Our Work

Linux Magazine content is made possible with support from readers like you. Please consider contributing when you've found an article to be beneficial.