1. typedoc-plugin-tutorials
Integrate tutorials to your documentation
typedoc-plugin-tutorials
Package: typedoc-plugin-tutorials
Created by: GerkinDev
Last modified: Sun, 22 May 2022 12:43:30 GMT
Version: 0.0.1-alpha.1
License: MIT
Downloads: 81
Repository: https://github.com/GerkinDev/typedoc-plugin-tutorials

Install

npm install typedoc-plugin-tutorials
yarn add typedoc-plugin-tutorials

Typedoc-plugin-tutorials

This typedoc plugin allows you to create tutorials for your typedoc documentation. Those tutorial pages will be generated using your theme. The tutorial index is added as a doc page visible in the global menu of your documentation. This page generates a basic index page containing all your tutorials.

Example generated tutorials page: https://gerkindev.github.io/vuejs-datatable/tutorials/index.html

Example typedoc.json file:

 {
	"tutorials-map": "./tutorials/tutorials.json",
	"tutorials-directory": "./tutorials"
}

In this examples, tutorials general informations (title, description & children) will be loaded from ./tutorials/tutorials.json. Markdown files (.md) are expected to be found under the ./tutorials directory.

Example tutorials.json file

 {
	"my-first-tutorial": {
		"title": "My first tutorial",
		"description": "This tutorial is just an introduction",
		"children": {
			"my-second-tutorial": {
				"title": "My second tutorial",
				"description": "This tutorial is a child of the 1st tutorial"
			}
		}
	},
	"hello-world": {
		"title": "Hello world"
	}
}

This configuration will look for my-first-tutorial.md, my-second-tutorial.md & hello-world.md in the specified tutorials directory and render them as tutorial pages.

Each tutorial key must be unique, even through children.

In your doc comments, linking with tutorials can be done the following ways:

 /**
 * This is the description of the doc comment. Here is a link to [[tutorial:my-first-tutorial]].
 *
 * @tutorial my-second-tutorial An optional descriptionto attach to the tutorial
 */
void myFunc(){}

Dependencies

RELATED POST

Enhancing Vue.js Development: Harnessing the Potential of Vue-Loader

Enhancing Vue.js Development: Harnessing the Potential of Vue-Loader

Simplify Data Validation in Vue.js: A Step-by-Step Guide to Using Regex

Simplify Data Validation in Vue.js: A Step-by-Step Guide to Using Regex

Troubleshooting Made Easy: Common Issues and Solutions with vue-loader Without vue-cli

Troubleshooting Made Easy: Common Issues and Solutions with vue-loader Without vue-cli

Optimizing Webpack 4 with Vue CLI 3: Disabling the Cache-Loader

Optimizing Webpack 4 with Vue CLI 3: Disabling the Cache-Loader

Step-by-Step Guide: How to Add a Function to Your Vuex Plugin

Step-by-Step Guide: How to Add a Function to Your Vuex Plugin