docula 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) Jared Wray
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,52 @@
1
+ <img src="site/branding-guidelines/Docula Logos/PNG/Color/docula.png" />
2
+
3
+ # Docula
4
+
5
+ [![tests](https://github.com/jaredwray/docula/actions/workflows/tests.yaml/badge.svg)](https://github.com/jaredwray/docula/actions/workflows/tests.yaml)
6
+ [![codecov](https://codecov.io/github/jaredwray/docula/branch/main/graph/badge.svg?token=RS0GPY4V4M)](https://codecov.io/github/jaredwray/docula)
7
+
8
+ ## :warning: - this is currently under development. Please do not use.
9
+
10
+ ## Features
11
+
12
+ - Zero Config - Just drop it in and it works
13
+ - Can run from `npx` or installed globally
14
+ - Knowledge Base that is easy to setup and manage
15
+ - Beautiful and Responsive Design (Like Stripe or 11ty)
16
+ - Search Engine Optimized
17
+ - Search Engine Plugin (Algolia) that pushes the content to the search service.
18
+ - Convention over Configuration - just add your files, use a template (or build your own) and you're done.
19
+ - Will generate a sitemap.xml
20
+ - Will generate a robots.txt
21
+ - Will generate a release based on Github Releases
22
+ - Generatses an RSS feed.xml file to use and share
23
+
24
+ ## Site Structure
25
+
26
+ - `site/docs` - contains the documentation files
27
+ - `site/template` - contains the templates files
28
+ - `site/blog` - contains the blog files and images
29
+
30
+ This will all be generated in the `dist` folder by default. To change that you can use the `--output=<folder_name>` flag.
31
+
32
+ ### Github Integration
33
+ - Pull all of your Contributors and Display Them
34
+ - Pulls your release notes and puts it into a good looking data format for your templates
35
+ - Pulls your project stats based on Github Forks, Stars, and Watchers
36
+ ## How the CLI should work
37
+ To create a new project it should be as simple as:
38
+ ```bash
39
+ docula init <project-name>
40
+ ```
41
+
42
+ This will actually do all the scaffolding for the site setting up the package.json, the config file, and the templates. It will also install the default template.
43
+
44
+ To build the site just do:
45
+ ```bash
46
+ docula <path optional>
47
+ ```
48
+
49
+ To build the site and watch for changes:
50
+ ```bash
51
+ docula <path optional> --serve --watch --port=8081
52
+ ```
package/bin/docula.js ADDED
@@ -0,0 +1,7 @@
1
+ #!/usr/bin/env node
2
+ import {Executable} from '../dist/index.js';
3
+
4
+ const docula = new Executable();
5
+
6
+ // eslint-disable-next-line unicorn/prefer-top-level-await, n/prefer-global/process
7
+ docula.parseCLI(process).then();
@@ -0,0 +1,4 @@
1
+ {
2
+ "authorName": "Jared Wray",
3
+ "footer": "License MIT and Copyright"
4
+ }