
Understand how editor, preview and navigation help in day-to-day technical writing. See how the editor can validate the contents for broken references.
Installing IntelliJ on the local machine using the JetBrains toolbox.
Starting the IDE the for the time, learn about the free JetBrains trainings, and installing the AsciiDoc plugin from the JetBrains Marketplace.
How to open a single or multiple projects. Basic navigation within a project.
Add an AsciiDoc file to a project, overview of the basics of editor and preview and how to navigate.
Optimize the preview so that it resolves attribute placeholders and show images even when they are in other folders. Optionally, use the production site's stylesheet to get a preview in the IDE that matches the layout of your production site.
Learn the AsciiDoc Syntax with a small set of training exercises called "Katas". This will make you familiar with the AsciiDoc syntax and the AsciiDoc Language Documentation.
Showing the basics of working with IntelliJ and GitHub on how to create a pull request for a project.
Once you’re working in a documentation project, there are usually a lot of files involved for different pages and chapters.
There are a lot of references to images and includes.
When you can navigate them effectively, you’ll get your work done faster.
For both navigation and searching, IntelliJ preprocesses the data in project and adds indexes, so all of those searches are fast.
New to IntelliJ IDEA and wonder how to get started with AsciiDoc and Documentation as Code? This beginner’s course takes from and installing IntelliJ IDEA to using it effectively to write, review and navigate technical documentation written in AsciiDoc.
The AsciiDoc plugin for IntelliJ IDEA provides you with the best tools to write and validate your content in your IDE. All course material is presented by Alexander Schwartz, the maintainer of the AsciiDoc plugin for IntelliJ and an active member of the AsciiDoc community.
It covers all steps necessary to get you ready for Technical Writing with AsciiDoc and IntelliJ IDEA:
Installing IntelliJ IDEA as the workplace for technical writing.
Starting IntelliJ IDEA for the first time and installing the AsciiDoc plugin.
Opening the first project in IntelliJ IDEA.
Adding a file to a project and editing AsciiDoc content in an existing project.
Making use of the preview to validate the content.
Learning the AsciiDoc Syntax via small exercises.
Using IntelliJ to submit changes to Git via a pull request.
Navigating from one file to other referenced files in a project.
Searching AsciiDoc content in a large project.
After this course, you’ll be able to contribute to a documentation project that uses AsciiDoc for its technical documentation via IntelliJ IDEA.
During the course, you can contact the instructor with your questions.