emdgroup-liquid / liquid-docs

Lightweight starter project for markdown-based documentation pages

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Liquid docs

Join us on GitHub discussions Join us on Teams

Liquid docs is a starter project based on 11ty and Stencil and acts as the foundation for the Liquid Oxygen documentation.

Getting started

  1. Clone this repository:
git clone git@github.com:emdgroup-liquid/liquid-docs.git
  1. Install dependencies:
npm install
  1. Start up the development server:
npm start
  1. Edit markdown pages in src/docs/pages. Make sure to supply front matter data at the top of your markdown file. Here is an example:
---
eleventyNavigation:
  key: Getting started
  parent: Introduction
  order: 1
layout: layout.njk
title: Getting started
permalink: introduction/getting-started/
tags:
  - installation
  - setup
---
  1. Modify the functionality of the docs:
  • by editing existing or adding new components inside the folder src/docs/components. For instance, if you want to change the logo and the heading in the page header or if you want to replace / remove the GitHub button, head over to src/docs/components/docs-topbar.tsx and change it according to your requirements.
  • by configuring existing or adding new 11ty plugins, shortcodes, filters etc. in .eleventy.js.
  1. Deploy the dist-docs directory to the hosting environment of your choice.

Links

Contributing

If you'd like to contribute to the project, please read our code of conduct. Then proceed to the contributing docs.

License

This project is available under a custom license which restricts its usage to applications created for or by Merck KGaA, Darmstadt, Germany as well as its vendors.

About

Lightweight starter project for markdown-based documentation pages

License:Other


Languages

Language:CSS 45.7%Language:TypeScript 37.8%Language:JavaScript 9.8%Language:Nunjucks 6.6%Language:Dockerfile 0.1%