README

This is the source of my personal, public web page ¯\_(ツ)_/¯

Publishing my projects and notes has been great exercise for me. As long as this works well for me I will continue doing so :) The content may appear random as it deals with basically anything I find interesting and noteworthy :)

Visit https://0xfab1.net for online view. Built with GitHub Actions, GitHub Pages, Let's Encrypt and MkDocs with the Material theme.

Thanks for your interest and I appreciate your feedback and/or pull-request(s) for typos/errors in existing pages!

Stats

Type	Status
Build
Uptime
Repo
Issues

Build and Run

If you want to run the latest official docker hub build use this command and view result here: http://127.0.0.1:8000/

docker run -it --rm -p 8000:8000 0xfab1/0xfab1.net serve -a 0.0.0.0:8000

Python and MkDocs

Clone this repository with git. To create the page you need python, and the extension for MkDocs and some MkDocs add-ons. View the result here: http://127.0.0.1:8080/

pip install --upgrade pip
pip install -r requirements.txt --upgrade
git clone https://github.com/FullByte/FullByte.github.io.git 0xfab1.net
cd 0xfab1.net
mkdocs serve -a localhost:8080 --dirtyreload --watch-theme -v

Docker

Alternatively use docker to run a container with all required tools + website enabled. This repository contains a dockerfile in the main folder which can be used to build a new container with this command. View the result here: http://127.0.0.1:8000/

git clone https://github.com/FullByte/FullByte.github.io.git 0xfab1.net
cd 0xfab1.net
docker build -f dockerfile -t 0xfab1 .
docker run -d -p 80:80 -p 443:443 -v ./letsencrypt:/etc/letsencrypt -v ./certbot:/var/www/certbot --name website 0xfab1

Podman

git clone https://github.com/FullByte/FullByte.github.io.git 0xfab1.net
cd 0xfab1.net
podman build -f dockerfile -t 0xfab1 .
podman run -d -p 80:80 -p 443:443 -v ./letsencrypt:/etc/letsencrypt:Z -v ./certbot:/var/www/certbot:Z --name website 0xfab1

Contribute

I appreciate your pull-request for typos/errors in existing pages. If you think something is generally wrong or I missed to link you/someone where appropriate, please let me know!

• Fork the current version (e.g. with the GitHub CLI): gh repo fork https://github.com/FullByte/FullByte.github.io.git)
• Do the changes you want to make and commit the updates to your fork.
• Test the result by building the site with your update(s).
• If there are no errors and you are happy to share the change, open a pull request and briefly tell what you updated and why.

Thank you for your contribution :)

Contact