This branch contains the content and site generator of the https://linuxcontainers.org website.

Fixes, new content and translations are greatly appreciated. Read our contributing guidelines for details.

Take a look at the open issues on Github, to see where you could help.

To generate & run a local copy of the website, follow the instructions below.

Install the following software (naming may depends on your distribution):

• man2html-base
• python3 (>= 3.3)
• python3-bs4
• python3-jinja2
• python3-markdown (>= 3.3.4)
• python3-pygments
• pymdown-extensions

git clone https://github.com/lxc/linuxcontainers.org

Note: The folder downloads is quite big, so you can skip that folder by using git sparse-checkout & partial clones (The only exception is, when you work on the downloads page).

As a replacement for the missing downloads folder you need to create the following empty folders, before generating the website (otherwise the generator shows an error):

downloads/cgmanager/
downloads/distrobuilder/
downloads/lxc/
downloads/lxcfs/

All steps for creating a sparse checkout

#!/bin/bash

git clone --filter=blob:none --no-checkout [email protected]:lxc/linuxcontainers.org.git
cd linuxcontainers.org
git sparse-checkout set --no-cone
echo -e '/*\n!downloads' > .git/info/sparse-checkout
git checkout main
mkdir -p downloads/{incus,lxc,lxcfs,distrobuilder,cgmanager}

./generate

After generating the website(above), run these commands(Ubuntu-specific):

cd output
python3 -m http.server 8777

Now you can access the website in your browser by using your local IP address and port:

127.0.0.1:8777

Inside the container:

Install the dependencies, clone the repo and generate the website (same as above).

After generating the website, run these commands(Ubuntu-specific):

cd output
python3 -m http.server 8777

On the host:

You can now navigate to the site (in a browser of your choice) with the container's IP address, for example:

185.5.3.12:8777

Download the man pages from jenkins https://jenkins.linuxcontainers.org/job/lxc-build-tarballs/ and unzip them into the respective folder. For LXC:

tar xvf manpages.tar.gz -C linuxcontainers.org/manpages/lxc/

Ensure that man2html is installed. ./generate calls this tool and injects the main menu on top.

To install man2html:

apt install man2html

Bug reports, requests and ideas regarding the website can be filed at https://github.com/lxc/linuxcontainers.org/issues/new