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 +21 -0
- package/README.md +52 -0
- package/bin/docula.js +7 -0
- package/init/_data/site.json +4 -0
- package/init/_includes/assets/css/highlight/highlight.min.js +1433 -0
- package/init/_includes/assets/css/highlight/styles/base16/dracula.min.css +7 -0
- package/init/_includes/assets/css/styles/home.css +256 -0
- package/init/_includes/assets/css/styles/index.css +971 -0
- package/init/_includes/assets/css/styles/variables.css +30 -0
- package/init/_includes/assets/images/docula.png +0 -0
- package/init/_includes/assets/images/logo.svg +10 -0
- package/init/_includes/doc.njk +17 -0
- package/init/_includes/search/pagefind.njk +66 -0
- package/init/_includes/shared/head.njk +13 -0
- package/init/_includes/shared/header.njk +23 -0
- package/init/_includes/shared/homeHeader.njk +20 -0
- package/init/_includes/shared/main.njk +47 -0
- package/init/_includes/shared/scripts.njk +52 -0
- package/init/_includes/shared/searchModal.njk +10 -0
- package/init/_includes/shared/sidebar.njk +50 -0
- package/init/api/Readme.md +3 -0
- package/init/docs/Readme.md +83 -0
- package/init/docs/docs.json +13 -0
- package/init/index.njk +72 -0
- package/init/versions.njk +33 -0
- package/package.json +109 -0
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
|
+
[](https://github.com/jaredwray/docula/actions/workflows/tests.yaml)
|
|
6
|
+
[](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