Skip to content
/ open Public

GiG Open is an initiative from GiG to contribute back to the community. Here at GiG, we rely a lot on open technologies so this is our way to give back; both software and knowledge.

License

Notifications You must be signed in to change notification settings

GiG/open

Repository files navigation

GitHub Pages GitHub Discuss

GiG Open

This is the repository for the static documentation site for the open.gig.com microsite.

Building the site

This project is based on MkDocs using the Material for MkDocs theme. To build this project you'll need Python installed on your system, the Python package manager, pip as well as the mkdocs package. You can check if you have these already installed from the command line:

$ python --version
Python 3.8.2
$ pip --version
pip 20.0.2 from /usr/local/lib/python3.8/site-packages/pip (python 3.8)
$ mkdocs --version
mkdocs, version 0.15.3

MkDocs supports Python versions 3.5, 3.6, 3.7, 3.8, and pypy3. If these are not installed, you can follow the MkDocs installation documentation.

MkDocs comes with a built-in dev-server that lets you preview your documentation as you work on it. Make sure you're in the same directory as the mkdocs.yml configuration file, and then start the server by running the mkdocs serve command:

$ mkdocs serve
INFO    -  Building documentation...
INFO    -  Cleaning site directory
[I 160402 15:50:43 server:271] Serving on http://127.0.0.1:8000
[I 160402 15:50:43 handlers:58] Start watching changes
[I 160402 15:50:43 handlers:60] Start detecting changes
Open up http://127.0.0.1:8000/ in your browser

Run Development Server with Docker

First you need to build the image:

docker build . -t gig-open

Once the image is built, you can run the development server by mapping the MkDocs port and mounting your source volume to /src as follows:

Windows

docker run --rm -it -v "%cd%":/src -p 8000:8000 gig-open

Linux

docker run --rm -it -v ${PWD}:/src -p 8000:8000 gig-open

About

GiG Open is an initiative from GiG to contribute back to the community. Here at GiG, we rely a lot on open technologies so this is our way to give back; both software and knowledge.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks