• Codeholics Static Pelican Site
  • Clone Projects
  • Docker Setup
    • Build Docker Image
    • Run Docker Container
  • Manual Setup
    • Install pip
    • Install Venv
    • Setup Venv
    • Activate Venvu Enviornment
    • Install Python Requirements:
    • Build Site
    • Run Dev Server
  • Update Site Dependencies
  • Directory Structure
  • Resources

Codeholics.com static site generated with Pelican

# clone main project
git clone [email protected]:Codeholics/codeholics.git

# clone pelican plugins
git clone [email protected]:Codeholics/pelican-plugins.git

If you use Docker, otherwise follow the manual process

docker-compose -f docker/docker-compose.yml build

docker-compose -f docker/docker-compose.yml up

python -m pip install

pip install venv

You should create this under the root project folder. If you're using GitHub, make sure to exclude this directory in your gitignore file. It's also best practice to CD C:\Code\codeholics into the directory before running this command. This will create the directory C:\Code\codeholics\venvu

python -m venv C:\Code\codeholics

`C:\Code\codeholics\venv\Scripts\Activate.ps1`

cd codeholics
pip install -r requirements.txt

This step will build the site so you can view it with the dev server.

Content C:\Code\codeholics\Content is where all of your markdown documents are stored.

Output C:\Code\codeholics\output is where the final html version will be saved to.

pelican C:\Code\codeholics\Content

Start the dev server

pelican --listen # creates a server on port 8080

By default you should now see a message in the console

Server site at: http://127.0.0.1:8000

This will generate the requirements.txt from the requirements.in file

pip install pip-tools
pip-compile --update

- codeholics
  - .github
  - content
  - docker
  - include
  - output
  - themes
  - venv

• Pelican Website Generator