docs: Setup mkdocs with mkdocs-material theme
This changes the framework used to generate the klipper3d site. Signed-off-by: Damien Martin <damlobster@gmail.com>
This commit is contained in:
Damien
KevinOConnor
parent
cff61605fb
commit
ea802aa91e
|
|
@ -0,0 +1,29 @@
|
||||||
|
name: klipper3d deploy
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches:
|
||||||
|
- master
|
||||||
|
paths:
|
||||||
|
- docs/**
|
||||||
|
- mkdocs.yml
|
||||||
|
- .github/workflows/klipper3d-deploy.yaml
|
||||||
|
jobs:
|
||||||
|
deploy:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
- name: Setup python
|
||||||
|
uses: actions/setup-python@v2
|
||||||
|
with:
|
||||||
|
python-version: '3.8'
|
||||||
|
- uses: actions/cache@v2
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pip
|
||||||
|
key: ${{ runner.os }}-pip-${{ hashFiles('docs/_klipper3d/mkdocs-requirements.txt') }}
|
||||||
|
restore-keys: |
|
||||||
|
${{ runner.os }}-pip-
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r docs/_klipper3d/mkdocs-requirements.txt
|
||||||
|
- name: Build and deploy klipper3d
|
||||||
|
run: |
|
||||||
|
mkdocs gh-deploy --force --remote-branch gh-pages --verbose
|
||||||
|
|
@ -1,4 +0,0 @@
|
||||||
# This is a Jekyll config file that is used by "github pages" to
|
|
||||||
# produce the https://www.klipper3d.org/ website.
|
|
||||||
include: CONTRIBUTING.md
|
|
||||||
google_analytics: UA-138371409-1
|
|
||||||
|
|
@ -0,0 +1,15 @@
|
||||||
|
[data-md-color-scheme="slate"] {
|
||||||
|
--md-primary-fg-color: hsla(var(--md-hue),15%,12%,1);
|
||||||
|
--md-default-bg-color: hsla(var(--md-hue),17%,17%,1);
|
||||||
|
--md-typeset-a-color: steelblue;
|
||||||
|
--md-accent-fg-color: lightblue;
|
||||||
|
}
|
||||||
|
|
||||||
|
img {
|
||||||
|
background-color: white;
|
||||||
|
}
|
||||||
|
|
||||||
|
.center-image {
|
||||||
|
margin: 0 auto;
|
||||||
|
display: block;
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,8 @@
|
||||||
|
mkdocs==1.2.2
|
||||||
|
mkdocs-material==7.2.0
|
||||||
|
mkdocs-section-index==0.3.1
|
||||||
|
mkdocs-simple-hooks==0.1.3
|
||||||
|
mkdocs-exclude==1.0.2
|
||||||
|
mdx-truly-sane-lists==1.2
|
||||||
|
mdx-breakless-lists==1.0.1
|
||||||
|
py-gfm==1.0.2
|
||||||
|
|
@ -0,0 +1,18 @@
|
||||||
|
import re
|
||||||
|
|
||||||
|
def transform(markdown: str, page, config, files):
|
||||||
|
in_list = False
|
||||||
|
lines = markdown.splitlines()
|
||||||
|
for i in range(len(lines)):
|
||||||
|
lines[i] = lines[i].replace('](../',
|
||||||
|
f"]({config['repo_url']}blob/master/")
|
||||||
|
lines[i] = re.sub(r"\\", "<br>", lines[i])
|
||||||
|
# check that lists at level 0 are not indented (no space before *|-|1.)
|
||||||
|
if len(lines[i]) == 0:
|
||||||
|
in_list = False
|
||||||
|
elif re.match(r"^(\*|-|\d+\.) ", lines[i]):
|
||||||
|
in_list = True
|
||||||
|
if not in_list:
|
||||||
|
lines[i] = re.sub(r"^\s+(\*|-|\d+\.) ", r"\1 ", lines[i])
|
||||||
|
output = "\n".join(lines)
|
||||||
|
return output
|
||||||
|
|
@ -1,5 +0,0 @@
|
||||||
This directory defines the https://www.klipper3d.org/ website. The
|
|
||||||
site is hosted using "github pages" (which uses Jekyll to
|
|
||||||
automatically convert the markdown files in the docs/ directory to
|
|
||||||
html). In addition to the files in this directory, the docs/CNAME and
|
|
||||||
docs/_config.yml file also control the website generation.
|
|
||||||
|
|
@ -1,139 +0,0 @@
|
||||||
<!DOCTYPE html>
|
|
||||||
<html>
|
|
||||||
<head>
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
|
|
||||||
{% seo %}
|
|
||||||
|
|
||||||
<!-- Bootstrap css -->
|
|
||||||
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T" crossorigin="anonymous">
|
|
||||||
|
|
||||||
<!-- Fixup markdown code blocks -->
|
|
||||||
<style>
|
|
||||||
.markdown-body pre {
|
|
||||||
background-color: #f6f8fa;
|
|
||||||
line-height: 1.45;
|
|
||||||
overflow: auto;
|
|
||||||
padding: 16px;
|
|
||||||
}
|
|
||||||
.markdown-body code, .markdown-body tt {
|
|
||||||
background-color: rgba(27,31,35,.1);
|
|
||||||
color: inherit;
|
|
||||||
border-radius: 3px;
|
|
||||||
font-size: 85%;
|
|
||||||
margin: 0;
|
|
||||||
padding: .2em .4em;
|
|
||||||
}
|
|
||||||
.markdown-body pre code {
|
|
||||||
padding: 0;
|
|
||||||
background: transparent;
|
|
||||||
}
|
|
||||||
|
|
||||||
.markdown-body table td, .markdown-body table th {
|
|
||||||
border: 1px solid #dfe2e5;
|
|
||||||
padding: 6px 13px;
|
|
||||||
}
|
|
||||||
.markdown-body table tr {
|
|
||||||
background-color: #fff;
|
|
||||||
border-top: 1px solid #c6cbd1;
|
|
||||||
}
|
|
||||||
.markdown-body table tr:nth-child(2n) {
|
|
||||||
background-color: #f6f8fa;
|
|
||||||
}
|
|
||||||
.markdown-body table {
|
|
||||||
margin-bottom: 16px;
|
|
||||||
}
|
|
||||||
</style>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
|
|
||||||
<!-- Navbar at top of page -->
|
|
||||||
<nav class="navbar navbar-expand-md navbar-light bg-light">
|
|
||||||
<a class="navbar-brand" href="/">
|
|
||||||
<img src="img/klipper-logo-small.png" alt="Klipper">
|
|
||||||
</a>
|
|
||||||
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNavAltMarkup" aria-controls="navbarNavAltMarkup" aria-expanded="false" aria-label="Toggle navigation">
|
|
||||||
<span class="navbar-toggler-icon"></span>
|
|
||||||
</button>
|
|
||||||
<div class="collapse navbar-collapse" id="navbarNavAltMarkup">
|
|
||||||
<div class="navbar-nav ml-auto">
|
|
||||||
<a class="nav-item nav-link" href="Overview.html">Documentation</a>
|
|
||||||
<a class="nav-item nav-link" href="https://github.com/KevinOConnor/klipper">Github</a>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</nav>
|
|
||||||
|
|
||||||
<div class="container-fluid">
|
|
||||||
<div class="row">
|
|
||||||
|
|
||||||
<!-- Sidebar for table of contents -->
|
|
||||||
<nav class="d-none d-md-block col-md-3 bg-light">
|
|
||||||
<ul id="toc" class="px-0" style="list-style: none">
|
|
||||||
</ul>
|
|
||||||
</nav>
|
|
||||||
|
|
||||||
<!-- Main markdown contents -->
|
|
||||||
<main class="col-md-9 ml-md-auto px-4">
|
|
||||||
<div class="markdown-body" style="max-width: 800px">
|
|
||||||
{{ content }}
|
|
||||||
</div>
|
|
||||||
</main>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- Google analytics javascript -->
|
|
||||||
{% if site.google_analytics %}
|
|
||||||
<script>
|
|
||||||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
|
||||||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
|
||||||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
|
||||||
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
|
|
||||||
ga('create', '{{ site.google_analytics }}', 'auto');
|
|
||||||
ga('send', 'pageview');
|
|
||||||
</script>
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
<!-- Bootstrap / jquery javascript -->
|
|
||||||
<script src="https://code.jquery.com/jquery-3.3.1.slim.min.js" integrity="sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo" crossorigin="anonymous"></script>
|
|
||||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.7/umd/popper.min.js" integrity="sha384-UO2eT0CpHqdSJQ6hJty5KVphtPhzWj9WO1clHTMGa3JDZwrnQq4sF86dIHNDz0W1" crossorigin="anonymous"></script>
|
|
||||||
<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/js/bootstrap.min.js" integrity="sha384-JjSmVgyd0p3pXB1rRibZUAYoIIy6OrQ6VrjIEaFf/nJGzIxFDsf4x0xIM+B07jRM" crossorigin="anonymous"></script>
|
|
||||||
|
|
||||||
<!-- Javascript to automatically add table of contents -->
|
|
||||||
<style>
|
|
||||||
.toc-item {
|
|
||||||
font-size: 80%;
|
|
||||||
line-height: 80%;
|
|
||||||
padding-top: .5em;
|
|
||||||
padding-bottom: .5em;
|
|
||||||
}
|
|
||||||
.toc-item-H1 { margin-left: 0px; }
|
|
||||||
.toc-item-H2 { margin-left: 8px; }
|
|
||||||
.toc-item-H3, .toc-item-H4, .toc-item-H5, .toc-item-H6 { margin-left: 16px; }
|
|
||||||
</style>
|
|
||||||
<script>
|
|
||||||
var levels = [];
|
|
||||||
$('.markdown-body').find('h1, h2, h3, h4, h5, h6').each(function() {
|
|
||||||
var $item = $(this);
|
|
||||||
var $id = $(this).attr('id');
|
|
||||||
var li = $('<li class="toc-item"/>');
|
|
||||||
var tag = $item.prop("tagName");
|
|
||||||
while (levels.length && tag <= levels[levels.length - 1]) {
|
|
||||||
levels.pop();
|
|
||||||
}
|
|
||||||
levels.push(tag);
|
|
||||||
li.addClass("toc-item-H" + levels.length);
|
|
||||||
var a = $('<a/>', {text: $item.text(), href: '#' + $id, title: $item.text()});
|
|
||||||
a.appendTo(li);
|
|
||||||
$('#toc').append(li);
|
|
||||||
});
|
|
||||||
</script>
|
|
||||||
|
|
||||||
<!-- Javascript to automatically fix links to files outside docs/ -->
|
|
||||||
<script>
|
|
||||||
$('.markdown-body').find('a[href^="../"]').each(function() {
|
|
||||||
this.href = $(this).attr("href").replace(/^\.\./, "https://github.com/KevinOConnor/klipper/blob/master");
|
|
||||||
});
|
|
||||||
</script>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
|
|
@ -1,16 +0,0 @@
|
||||||
---
|
|
||||||
# This file defines the main https://www.klipper3d.org/ page.
|
|
||||||
layout: default
|
|
||||||
---
|
|
||||||
<p class="text-center"><img src="img/klipper-logo.png"/></p>
|
|
||||||
|
|
||||||
<p>Klipper is a 3d-Printer firmware. It combines the power of a general
|
|
||||||
purpose computer with one or more micro-controllers. See the
|
|
||||||
<a href="/Features.html">features</a> document for more information on why you
|
|
||||||
should use Klipper.</p>
|
|
||||||
|
|
||||||
<p>To begin using Klipper start by <a href="/Installation.html">installing</a> it.</p>
|
|
||||||
|
|
||||||
<p>Klipper is Free Software. Read the <a href="/Overview.html">documentation</a> or
|
|
||||||
view
|
|
||||||
<a href="https://github.com/KevinOConnor/klipper">the Klipper code on github</a>.</p>
|
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 8.0 KiB |
|
|
@ -1,6 +1,5 @@
|
||||||
---
|
---
|
||||||
hide:
|
hide:
|
||||||
- navigation
|
|
||||||
- toc
|
- toc
|
||||||
title: Welcome
|
title: Welcome
|
||||||
---
|
---
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,119 @@
|
||||||
|
site_name: Klipper documentation
|
||||||
|
theme:
|
||||||
|
name: material
|
||||||
|
palette:
|
||||||
|
- media: "(prefers-color-scheme: light)"
|
||||||
|
scheme: default
|
||||||
|
primary: white
|
||||||
|
accent: blue
|
||||||
|
toggle:
|
||||||
|
icon: material/lightbulb
|
||||||
|
name: Switch to dark mode
|
||||||
|
- media: "(prefers-color-scheme: dark)"
|
||||||
|
scheme: slate
|
||||||
|
primary: grey
|
||||||
|
accent: light blue
|
||||||
|
toggle:
|
||||||
|
icon: material/lightbulb-outline
|
||||||
|
name: Switch to light mode
|
||||||
|
# primary: white
|
||||||
|
# accent: blue
|
||||||
|
logo: img/klipper.svg
|
||||||
|
favicon: img/favicon.ico
|
||||||
|
icon:
|
||||||
|
repo: fontawesome/brands/github
|
||||||
|
features:
|
||||||
|
- navigation.instant
|
||||||
|
#- navigation.tabs
|
||||||
|
#- navigation.expand
|
||||||
|
- navigation.top
|
||||||
|
# if enabled, the TOC doesn't work for some pages
|
||||||
|
# - toc.integrate
|
||||||
|
- search.suggest
|
||||||
|
- search.highlight
|
||||||
|
- search.share
|
||||||
|
extra_css:
|
||||||
|
- _klipper3d/css/extra.css
|
||||||
|
repo_url: https://github.com/KevinOConnor/klipper
|
||||||
|
repo_name: KevinOConnor/klipper
|
||||||
|
edit_uri: blob/master/docs/
|
||||||
|
plugins:
|
||||||
|
- search
|
||||||
|
- section-index
|
||||||
|
- mkdocs-simple-hooks:
|
||||||
|
hooks:
|
||||||
|
on_page_markdown: "docs._klipper3d.mkdocs_hooks:transform"
|
||||||
|
- exclude:
|
||||||
|
glob:
|
||||||
|
- README.md
|
||||||
|
markdown_extensions:
|
||||||
|
- toc:
|
||||||
|
permalink: True
|
||||||
|
toc_depth: 6
|
||||||
|
#- pymdownx.snippets
|
||||||
|
- attr_list
|
||||||
|
- mdx_partial_gfm
|
||||||
|
- mdx_truly_sane_lists
|
||||||
|
- mdx_breakless_lists
|
||||||
|
|
||||||
|
extra:
|
||||||
|
analytics:
|
||||||
|
# https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/#site-search-tracking
|
||||||
|
provider: google
|
||||||
|
property: UA-138371409-1
|
||||||
|
# version:
|
||||||
|
# provider: mike
|
||||||
|
nav:
|
||||||
|
- Overview:
|
||||||
|
- Overview.md
|
||||||
|
- Features.md
|
||||||
|
- FAQ.md
|
||||||
|
- Releases.md
|
||||||
|
- Config_Changes.md
|
||||||
|
- Contact.md
|
||||||
|
- Configuration and Tuning:
|
||||||
|
- Installation.md
|
||||||
|
- Configuration reference:
|
||||||
|
- Config_Reference.md
|
||||||
|
- Rotation_Distance.md
|
||||||
|
- Config_checks.md
|
||||||
|
- Bed level:
|
||||||
|
- Bed_Level.md
|
||||||
|
- Delta_Calibrate.md
|
||||||
|
- Probe_Calibrate.md
|
||||||
|
- BLTouch.md
|
||||||
|
- Manual_Level.md
|
||||||
|
- Bed_Mesh.md
|
||||||
|
- Endstop_Phase.md
|
||||||
|
- Resonance compensation:
|
||||||
|
- Resonance_Compensation.md
|
||||||
|
- Measuring_Resonances.md
|
||||||
|
- Pressure_Advance.md
|
||||||
|
- Slicers.md
|
||||||
|
- Command templates:
|
||||||
|
- Command_Templates.md
|
||||||
|
- Status_Reference.md
|
||||||
|
- TMC_Drivers.md
|
||||||
|
- skew_correction.md
|
||||||
|
- Using_PWM_Tools.md
|
||||||
|
- G-Codes.md
|
||||||
|
- Developer documentation:
|
||||||
|
- Code_Overview.md
|
||||||
|
- Kinematics.md
|
||||||
|
- Protocol.md
|
||||||
|
- API_Server.md
|
||||||
|
- MCU_Commands.md
|
||||||
|
- CANBUS_protocol.md
|
||||||
|
- Debugging.md
|
||||||
|
- Benchmarks.md
|
||||||
|
- CONTRIBUTING.md
|
||||||
|
- Packaging.md
|
||||||
|
- Device specific documents:
|
||||||
|
- Example_Configs.md
|
||||||
|
- SDCard_Updates.md
|
||||||
|
- RPi_microcontroller.md
|
||||||
|
- beaglebone.md
|
||||||
|
- Bootloaders.md
|
||||||
|
- CANBUS.md
|
||||||
|
- TSL1401CL_Filament_Width_Sensor.md
|
||||||
|
- HallFilamentWidthSensor.md
|
||||||
Loading…
Reference in New Issue