gecio.github.io

gecio.github.io

#jekyll#documentation#vscode
Demo Download

GEC Customer Documentation

This repository contains the customer documentation for GEC.



Setup

Hint: A quickstart devcontainer is down below.

To be able to build and run this project, Ruby 2.4 or higher is required. In addition, RubyGems, GCC and Make must be installed. See Jekyll Installation for further details.

One those prerequisites are set up, install all dependencies by running:

bundle install

Now, the following commands are available:

Command Description
jekyll serve Starts a development build
jekyll build Creates a production build

Jekyll will put the build output in the _site folder, while also keeping a cache in .jekyll-cache



Project

This project is structured the following way:

  • Dependencies (e.g. theme, plugins) are defined in Gemfile and pinned by Gemfile.lock
  • The Jekyll configuration (including configurations for theming and plugins) is defined in _config.yml
  • Theme customizations (for the "Just the Docs" theme) are placed in
    • the _includes folder for custom HTML templates
    • the _sass folder for custom SASS styling

All other folders containing markdown files and assets are the actual site content. Sites that exist in multiple languages can be placed right next to each other (e.g. index.de.md and index.en.md), and assets (such as images) can be placed right next to the pages using them.



Tools & dependencies

The following tools & dependencies are being used:

Tool / dependencie Description
Jekyll Static Site Generator
Just the Docs Jekyll theme
polyglot Jekyll plugin for internationalization
jekyll-postfiles Jekyll plugin for using assets placed next to markdown files



Using the (experimental) docker environment

Requirements

Procedure

  • Clone this repository
  • Open it in Visual Studio Code
  • VSCode will prompt, if you want to run the integrated dev container, select yes
  • Wait for the build to finish, it might take some minutes on the first run
  • Have fun!

Hints

  • Your ssh agent and git configuration should automatically be available inside the dev container.
  • You can change the devcontainer image to your preferences, by adding a Dotfile-Repository
minimalacademicresumeportfoliodocumentationwikitailwindbootstrapdarkecommercegithub-pagesblog