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 git@github.com: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