From caa8e705ee2838b9ed452cefa9e738afff675bc8 Mon Sep 17 00:00:00 2001 From: Robert Kaussow Date: Sat, 4 Apr 2020 14:43:27 +0200 Subject: [PATCH] add minimal documentation --- README.md | 17 +++++++++++++++ corenetworks/docs/config.yaml | 31 ++++++++++++++++++++++++++++ corenetworks/docs/data/menu/main.yml | 6 ++++++ corenetworks/docs/data/menu/more.yml | 10 +++++++++ corenetworks/docs/static/.htaccess | 16 ++++++++++++++ corenetworks/docs/static/_index.md | 12 +++++++++++ 6 files changed, 92 insertions(+) create mode 100644 corenetworks/docs/config.yaml create mode 100644 corenetworks/docs/data/menu/main.yml create mode 100644 corenetworks/docs/data/menu/more.yml create mode 100644 corenetworks/docs/static/.htaccess create mode 100644 corenetworks/docs/static/_index.md diff --git a/README.md b/README.md index b68fe4a..6e165b9 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,20 @@ # corenetworks +[![Build Status](https://img.shields.io/drone/build/xoxys/corenetworks?logo=drone)](https://cloud.drone.io/xoxys/corenetworks) +[![Python Version](https://img.shields.io/pypi/pyversions/corenetworks.svg)](https://pypi.org/project/corenetworks/) +[![PyPi Status](https://img.shields.io/pypi/status/corenetworks.svg)](https://pypi.org/project/corenetworks/) +[![PyPi Release](https://img.shields.io/pypi/v/corenetworks.svg)](https://pypi.org/project/corenetworks/) +[![Codecov](https://img.shields.io/codecov/c/github/xoxys/corenetworks)](https://codecov.io/gh/xoxys/corenetworks) +[![License: MIT](https://img.shields.io/github/license/xoxys/corenetworks)](LICENSE) + Python library for the [https://core-networks.de](https://beta.api.core-networks.de/doc/) DNS API. + +You can find the full documentation at [https://corenetworks.geekdocs.de](https://corenetworks.geekdocs.de/). + +## License + +This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details. + +## Maintainers and Contributors + +[Robert Kaussow](https://github.com/xoxys) diff --git a/corenetworks/docs/config.yaml b/corenetworks/docs/config.yaml new file mode 100644 index 0000000..bc5427e --- /dev/null +++ b/corenetworks/docs/config.yaml @@ -0,0 +1,31 @@ +--- +baseURL: https://corenetworks.geekdocs.de/ +title: corenetworks +theme: hugo-geekdoc +pygmentsUseClasses: true +pygmentsCodeFences: true + +# Geekdoc configuration +disablePathToLower: true +enableGitInfo: true + +# Needed for mermaid/katex shortcodes +markup: + goldmark: + renderer: + unsafe: true + tableOfContents: + startLevel: 1 + +params: + geekdocMenuBundle: true + geekdocToC: 3 + + geekdocRepo: https://github.com/xoxys/corenetworks + geekdocEditPath: edit/master/docs/content + + geekdocDateFormat: "Jan 2, 2006" + geekdocSearch: true + + geekdocLegalNotice: https://geeklabor.de/legal-notice/#impressum + geekdocPrivacyPolicy: https://geeklabor.de/legal-notice/#datenschutzerkl%C3%A4rung diff --git a/corenetworks/docs/data/menu/main.yml b/corenetworks/docs/data/menu/main.yml new file mode 100644 index 0000000..110a520 --- /dev/null +++ b/corenetworks/docs/data/menu/main.yml @@ -0,0 +1,6 @@ +--- +main: + - name: Setup + ref: "/setup" + - name: Usage + ref: "/usage" diff --git a/corenetworks/docs/data/menu/more.yml b/corenetworks/docs/data/menu/more.yml new file mode 100644 index 0000000..ee79e4e --- /dev/null +++ b/corenetworks/docs/data/menu/more.yml @@ -0,0 +1,10 @@ +--- +more: + - name: Releases + ref: "https://github.com/xoxys/corenetworks/releases" + external: true + icon: "download" + - name: "View Source" + ref: "https://github.com/xoxys/corenetworks" + external: true + icon: "github" diff --git a/corenetworks/docs/static/.htaccess b/corenetworks/docs/static/.htaccess new file mode 100644 index 0000000..b5a07f4 --- /dev/null +++ b/corenetworks/docs/static/.htaccess @@ -0,0 +1,16 @@ +ErrorDocument 404 /404.html + +ExpiresActive On +ExpiresDefault "access plus 600 seconds" +ExpiresByType text/css "access plus 1 week" +ExpiresByType text/javascript "access plus 1 month" +ExpiresByType text/html "access plus 1 seconds" +ExpiresByType application/javascript "access plus 1 month" +ExpiresByType application/x-javascript "access plus 1 month" +ExpiresByType image/gif "access plus 1 week" +ExpiresByType image/jpeg "access plus 1 week" +ExpiresByType image/png "access plus 1 week" +ExpiresByType image/x-icon "access plus 1 month" +ExpiresByType image/svg+xml "access plus 1 week" +ExpiresByType application/x-font-woff "access plus 1 week" +ExpiresByType application/font-woff2 "access plus 1 week" diff --git a/corenetworks/docs/static/_index.md b/corenetworks/docs/static/_index.md new file mode 100644 index 0000000..b5374aa --- /dev/null +++ b/corenetworks/docs/static/_index.md @@ -0,0 +1,12 @@ +--- +title: Documentation +--- + +[![Build Status](https://img.shields.io/drone/build/xoxys/corenetworks?logo=drone)](https://cloud.drone.io/xoxys/corenetworks/) +[![Python Version](https://img.shields.io/pypi/pyversions/corenetworks.svg)](https://pypi.org/project/corenetworks/) +[![PyPi Status](https://img.shields.io/pypi/status/corenetworks.svg)](https://pypi.org/project/corenetworks/) +[![PyPi Release](https://img.shields.io/pypi/v/corenetworks.svg)](https://pypi.org/project/corenetworks/) +[![Codecov](https://img.shields.io/codecov/c/github/xoxys/corenetworks)](https://codecov.io/gh/xoxys/corenetworks) +[![License: MIT](https://img.shields.io/github/license/xoxys/corenetworks)](LICENSE) + +Python library for the [https://core-networks.de](https://beta.api.core-networks.de/doc/) DNS API.