Setting up Atom
This post will help you to set up your Atom with the appropriate plugins to speed up your development process. If you have not installed Atom so far, check out our blog-post on Install Atom with LiaScript. It will guide you through the installation procedure for Atom and the two LiaScript plugins and tell you something about the navigation within a document. However, there exist a couple of other plugins for Atom that are very handy and simplify the writing process for Markdown and of course LiaScript
Whether you are using Atom or VSCode as your main editor, the main keystrokes you have to remember are [Ctrl-S] to save the current document you are in, and the other one is [Ctrl-Shift-P] to get into a fuzzy search over all possible options.
This module is already installed by default, but for some reason, we had to enable it first for Markdown. You can either hit [Ctrl+,] and the settings-view will open immediately, or you can use the magic keystroke [Ctrl+Shift+P] to get to the fuzzy search and type
settings. After that, hit enter and in both cases, you should be presented with a view similar to one displayed in the image below:
Click onto the Packages-tab on the left, which lists all the installed packages and type
spell-check into the main input field, or simply scroll down your list until you find it. Then click onto the settings-button for the spell-check plugin and append
, text.md to the default list of grammar file types. Doing so, we tell Atom to apply this plugin onto all of our Markdown files. Last but not least, you can also specify the language to check within the Locals settings. In our case, this was en-US, but any other language shortcut (IETF-language-tag) is also possible. You will have to restart Atom.
However, this plugin will only use the system internal spell-checker.
If spell-checking is not working for some reason, you might have to install it manually. Please follow the instructions of the package maintainers, which can be found here.
Minimap gives you a nice overview on your documents, as depicted below. This comes handy when you need to scroll through a larger document. Minimap will show you your position within the file, and you can click onto your minimap to navigate within your document.
To install minimap, go to the settings via [Ctrl+,] or hit [Ctrl+Shift+P] and type
settings info the fuzzy search. Within the settings-view you will have to click onto the install-tab and type
minimap into the search. Do not directly install the first plugin, but search for the one whose title is exactly
minimap and then click on install. That's it, now you will be presented with a nice little map of your documents on the right.
For more information, see the project-page.
Although syntax-highlighting for Markdown files should already work, you can install the
language-markdown package too. The procedure is the same as for minimap, but this time you have to search for
language-markdown instead. This will add additional grammar support for Markdown (including Github flavored, AtomDoc, Markdown Extra, CriticMark, YAML/TOML front-matter, and R Markdown), and smart context-aware behavior to lists, and keyboard shortcuts for inline emphasis. As shown in the demonstration below, this will automatically add new bullet-points for you, or by selecting a word or a phrase and then typing *, _, `, etc. it will automatically add these annotations to your selection.
More information can be found here.
This is one of the most beautiful packages and a need for everyone who writes Markdown. It will automatically format tables, add spaces, cells, and rows for you. No need to manually hit spaces anymore. For jumping from cell to cell, simply use the [Tab] key.
Have a look at the project-website for a detailed description of all features.
After installing this plugin, you will never have to search for a unicode-icon or emoji again. Only type colon and search for the icon that you want to insert. In LiaScript you can add emojis everywhere, in titles, and even in ASCII-Art images.
This is not only useful for Markdown. Simply write between parenthesis your mathematical formula and this plugin will perform the calculation for you. It is based on Math.js and can do more than simple calculations.
It is not only possible to convert between different entities, but also to make calculation with different ones. Thereby the first entity defines the result, others will be translated into this first one.
(12cm to inch) --> 4.72440944882 inch (12days + 3months) --> 103.3125 days (3months + 12days) --> 3.39425051335 months (sin(45 deg) ^ 2) --> 0.5
As mentioned in the blog post Install Atom with LiaScript, it is for us and some others at the moment not possible to update our packages. Thus, the LiaScript snippets and preview plugins have to be installed from GitHub. The procedure to install these two packages is similar to the installation of the previews packages. Go to the settings, select the install tab and instead of typing
liascript-preview into the search field, you have to mention the GitHub repository first. In our case, these two projects are in:
That is why you have to insert
andre-dietrich/liascript-preview to install them directly from:
To activate the snippets, go to a Markdown file and type
lia all snippets are associated with this starting phrase. You can create a base stub for your course by typing
liainit and then hitting enter. But, you can also search for quizzes, code snippets, etc. simply by typing
lia and then searching or scrolling through the options. All snippets come with a little explanation and some examples.
There are two additional key-phrases, one is
voice and the other one is
hili, which stands for highlight-language. The first
voice-phrase can be used to search through all supported voices for the text-to-speech output, currently we rely on responsivevoice to support the same quality of spoken text on all browsers.
You can either hit [Ctrl+Shift+P] and then type
liascript into the fuzzy search to see all options for this plugin. In most cases, you want to toggle the preview for your course, that is why you also can use the short-cut [Alt+L], which will either open or close the preview-pane. Whenever you make changes to your document and save them, the preview will be reloaded. Use the short-cut [Ctrl-S] to save your document, this is a standard and works also in Word. To navigate through your document, you can use double-clicks. If you double-click on a word within the editor, the slide for this element will be opened with the preview. If you double-click onto an element within the preview, then the cursor will jump to the respective line within the editor.
For more keyboard short-cuts, hit [Ctrl+Shift+P] or visit the project website.