What are articles and chapters?
Articles: In Learn, knowledge is captured in the form of articles. Articles are like the pages in a book. For example, the design manual may contain articles for different topics like web UI elements, animations, navigation, etc.
Chapters: Similar articles can be grouped into chapters inside manuals. Chapters make your content more ordered and easier to navigate. For example, the web UI elements article can have chapters on input controls, pop-ups, and form layouts.
Creating articles
You can create an article in one of the following ways:
- Create a new article
- Create an article using a template
- Import an existing document
- Embed existing file into an article
Creating a new article
To create a new article:
- Navigate to the manual you want to create an article in.
- Click the Add () icon.
- Click Blank. You will be taken to the editor.
- To save your article as draft, click Save Draft in the top-right corner.
- Click Publish in the top-right to publish the article to the readers of the manual.
Creating articles using templates
You can create your article with one of the following template options:
- Default templates
- Custom templates
Creating articles using the default templates
To create articles using default templates:
- Navigate to the manual you want to create an article in.
- Click the Add () icon.
- Click From template, then go to the Default template tab.
- Select a default template from the list and enter a name for your article.
- Click Create. You will be taken to the editor.
- To save your article as draft, click Save Draft in the top-right corner.
- Click Publish in the top-right to publish the article to the readers of the manual.
Creating articles using custom templates
To create articles using custom templates:
- Navigate to the manual you want to create an article in.
- Click the Add (+) icon.
- Click From template, then go to the Custom template tab.
- Select a custom template and enter a name for your article.
- Click Create. You will be taken to the editor.
- To save your article as draft, click Save Draft in the top-right corner.
- Click Publish in the top-right to publish the article to the readers of the manual.
Custom templates is available only in our Professional plan.
Importing an existing document
If you have existing documents that you want to include in your knowledge base, you can easily import the documents instead of recreating them manually. After importing, you can also make any minor changes that are required in the article.
To import a document:
- Navigate to the manual you want to create an article in.
- Click the Add () icon, then click Import.
- Click Browse, then choose the file from your computer.
- Click Import.
- You can import RTF, HTM, HTML, DOCX, DOC, TXT, ODT, and zipped HTML files.
- Recommended file upload size for import is 10 MB
- The HTML file inside a ZIP file will be imported as a single article.
- The images with relative paths in the HTML file will also be imported.
- If there are multiple HTML files in the ZIP file, only the first file will be imported.
Embedding file into an article
Embed existing files to create new articles in a manual. If you want to make changes to the embedded file, you can replace it with a new file.
To embed a file:
- Navigate to the manual you want to create an article in.
- Click the Add () icon, then click Embed.
- Click Browse, then choose the file from your computer.
- Click Upload, then click Next.
- Select a chapter and provide a name for the article.
- Click Create.
You can embed PDF files into an article.