Skip to content

sachajw/ortelius-io-pangarabbit

 
 

Repository files navigation

Ortelius Website

The website is based on the hugo web server + the docsy theme.

Hugo uses markdown in conjunction with the themes to drive the formatting of the page content as html. Git is used to persist the markdown and themes and provides updating the web site via a Pull Request. The Ortelius Website Repo is where the production site is created from. Please fork the repo and use Pull Requests to get your changes merged back into the production site. See Contributing to Ortelius Project for details.

Git Repo Layout

  • /
    • /archetypes: default page type
    • /assets: override theme css and logo image
    • /chart: helm chart for deploying to Kubernetes
    • /cloudbuild: clouldbuild yaml to create the docker image, push to quary and deploy with DeployHub to the cluster
    • /content/en: markdown of the site content
    • /layouts: override theme layout for pages and divs on the pages
    • /public: used for runtime execution, ie. generated site
    • /resources: used for runtime execution, ie. generated site
    • /static: static files such as images, pdfs, videos, js
    • /themes: docsy theme
    • Dockerfile: docker file to build the image using klakegg/hugo:ext-alpine

Getting Started

  1. Fork and clone the repo
  2. Install hugo
    • Make sure for Windows to install hugo-extended
  3. Open a command prompt and cd to your repo dir
  4. Run: hugo server
  5. Access the local site using http://localhost:1313

Note: the site will automatically refresh on a file save.

Editing

Visual Studio which is free has a couple of useful plugins:

  • Docsy (Etienne Dldc)
  • Markdown Preview Enhanced (Yiyi Wang)
  • markdownlint (David Anson)

Merging your changes

Create a PR in the ortelius/website repo referencing your forked repo as where to merge from.

Make sure that you squash your commits in your local repo before doing your push. See the Git PR Cheatsheet for instructions. Also, reference any issues for example as resolves ortelius/ortelius#201 so they will close on the completion of the merge.

After your changes have been merge the Cloudbuild job will trigger and push your chnages to the Kubernetes cluster and the production site.

About

The ortelius.io website based on hugo/docsy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 54.1%
  • SCSS 43.1%
  • JavaScript 2.8%