From 3b2a3029b4adf67f3948b749bc76d9a853d2fb2f Mon Sep 17 00:00:00 2001 From: Antonio Date: Sun, 27 Feb 2022 13:12:55 +0200 Subject: [PATCH] docs(project): add initial setup for docs publishing --- docs/index.md | 62 ++++++++++++++++++++++++++++++++++++++++++++------- mkdocs.yml | 19 ++++++++++++++++ 2 files changed, 73 insertions(+), 8 deletions(-) create mode 100644 mkdocs.yml diff --git a/docs/index.md b/docs/index.md index ba35b70..720d8cc 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,9 +1,55 @@ -# Index +# Showdown documentation -1. Options -2. Subparsers -3. [Event System](event_system.md) - 1. [Introduction](event_system.md#introduction) - 2. [The Event Object](event_system.md#the-event-object) - 3. [Events](event_system.md#events) - 4. [Events List](event_system.md#events-list) +![Showdown][sd-logo] + +![Build Status: Linux](https://github.com/showdownjs/showdown/actions/workflows/node.linux.yml/badge.svg) +![Build Status: Windows](https://github.com/showdownjs/showdown/actions/workflows/node.win.yml/badge.svg) +[![npm version](https://badge.fury.io/js/showdown.svg)](http://badge.fury.io/js/showdown) +[![Bower version](https://badge.fury.io/bo/showdown.svg)](http://badge.fury.io/bo/showdown) +[![Join the chat at https://gitter.im/showdownjs/showdown](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/showdownjs/showdown?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) +[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.me/tiviesantos) + +Showdown is a JavaScript Markdown to HTML converter, based on the original works by John Gruber. +Showdown can be used on the client-side (in the browser) or server-side (with Node.js). + +---- + +## Live demo + + + +ShowdownJS is a free library and it will remain free forever. However, maintaining and improving the library costs time and money. + +If you like our work and find it useful, please donate through [PayPal](https://www.paypal.me/tiviesantos). + +Your contributions are greatly appreciated and will help us with the development of this awesome library. + +## Who uses Showdown (or a fork) + +* [GoogleCloudPlatform](https://github.com/GoogleCloudPlatform) +* [Meteor](https://www.meteor.com/) +* [StackExchange](http://stackexchange.com/) - forked as [PageDown](https://code.google.com/p/pagedown/) +* [docular](https://github.com/Vertafore/docular) +* [md-page](https://github.com/oscarmorrison/md-page) +* [QCObjects](https://qcobjects.dev) +* [Antmarky](https://github.com/bandantonio/antmarky) +* [and some others](https://www.npmjs.com/browse/depended/showdown) + +## License + +ShowdownJS v 2.0 is release under the MIT version. + +Previous versions are release under BSD. + +[sd-logo]: https://raw.githubusercontent.com/showdownjs/logo/master/dist/logo.readme.png +[legacy-branch]: https://github.com/showdownjs/showdown/tree/legacy +[releases]: https://github.com/showdownjs/showdown/releases +[changelog]: https://github.com/showdownjs/showdown/blob/master/CHANGELOG.md +[wiki]: https://github.com/showdownjs/showdown/wiki +[cli-wiki]: https://github.com/showdownjs/showdown/wiki/CLI-tool +[definitely-typed]: https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/showdown +[xss-wiki]: https://github.com/showdownjs/showdown/wiki/Markdown's-XSS-Vulnerability-(and-how-to-mitigate-it) +[ext-wiki]: https://github.com/showdownjs/showdown/wiki/extensions +[coding-rules]: https://github.com/showdownjs/code-style/blob/master/README.md +[ng-commit-guide]: https://github.com/showdownjs/code-style/blob/master/README.md#commit-message-convention +[boilerplate-repo]: https://github.com/showdownjs/extension-boilerplate \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..358c1f4 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,19 @@ +site_name: Showdown documentation +site_description: Showdown is a JavaScript Markdown to HTML converter + +theme: + name: material + logo: http://showdownjs.com/apple-touch-icon.png + favicon: http://showdownjs.com/apple-touch-icon.png + icon: + repo: fontawesome/brands/github + palette: + primary: red + accent: cyan + +repo_url: https://github.com/showdownjs/showdown +repo_name: showdownjs/showdown +site_dir: public + +nav: + - Home: index.md \ No newline at end of file