Files
AniCraft/docs/guide/using-this-guide.md
T

4.9 KiB
Raw Blame History

Using this guide

This guide comes with AniCraft and matches the version you have. It opens in your web browser and works without an internet connection. This chapter shows how to find things in it quickly: by searching, and by asking AniCraft for help on whatever you are working on.

On macOS, read ⌘ wherever this chapter says Ctrl.

Opening the guide

  • Help › User Guide opens the contents page.
  • Help › Help for This (F1) opens it at the section for what you are working on (see below).
  • Help › Search the User Guide opens the search page, ready for you to type.

All three are also in the command palette (Ctrl+K).

Searching the guide

Every page has a Search field at the top. Type a word or two and press Enter; the search page lists the sections that match, best first. On the search page itself the results update as you type.

Each result shows the section's heading, the chapter it is in and a short passage with your words highlighted. Click a result to go straight to that section.

  • Every word must match. onion skin finds the sections about onion skinning; onion gif finds only the ones that mention both.
  • Words match their longer forms. tween finds "tweens" and "tweening", and masks finds "mask".
  • Headings count most. A section whose heading has your words comes before one that only mentions them.
  • Small words such as "how", "do", "the" and "a" are skipped, so you can type a question: how do I add a camera.

With the keyboard

Key What it does
/ Goes to the search field from anywhere in the guide.
↓ and ↑ Move from the field through the results, and back.
Enter Opens the first result (or the result you are on).
Esc Clears the search; in the results, goes back to the field.

Screen readers announce how many results there are as you type.

Help for what you're working on

Press F1 in AniCraft and the guide opens at the section for what you are working on. AniCraft decides what that is in this order:

What Opens
A dialog that is waiting for an answer, such as Convert to Symbol or a question before a command That dialog, or the command it is asking about.
The command palette The command or tool you have chosen in it.
The window or panel under the pointer That window or panel: for example Publish Settings, the Library or the Timeline.
A tool's button under the pointer, or with keyboard focus That tool.
The stage The tool in your hand. Press F1 with the Bone tool and the guide opens at building an armature.
The panel with keyboard focus (Ctrl+F6 moves between them) That panel.
Anything else The window in front, or else the tool in your hand.

F1 works even while you are typing in a field or a dialog is open. The status bar names the section that opened.

Help › Help for This does the same from the menu. Because the pointer is on the menu then, it goes by the window in front, the focused panel or the tool in your hand.

From a panel's menu

Every panel's menu (the ☰ button at the end of its tab row, or a right-click on its tab) has ? Help for the panel at its end: ? Help for Library, ? Help for Swatches, and so on.

In the command palette

In the command palette (Ctrl+K), choose a command with the arrow keys and press F1 to read about it before you run it. The palette stays open.

F1 used to open the keyboard shortcut editor. That is now Ctrl+Alt+Shift+K, as in Animate, or Help › Keyboard Shortcuts. See Preferences, shortcuts, accessibility and languages.

Searching from the command line

anicraft-cli guide search searches the same guide from a terminal and prints the same results, in the same order, as the search page:

anicraft-cli guide search onion skin
anicraft-cli guide search export gif --limit 3 --json yes

See Working headless.

Printing the guide

Use your browser's Print to print a chapter, or to save it as a PDF (choose Save as PDF as the printer). The chapter list, the search field and the previous and next links are left out of the printout.

In the web version

In AniCraft in a web browser, the guide is served next to the editor and opens in a new tab. Search and Help › Help for This work there too. F1 does as well, but some browsers also open their own help page when you press it; use the menu item if yours does.

Not there yet

  • The guide in other languages. The interface can be translated already; the guide is English for now.
  • A PDF edition of the whole guide in one file. For now, print each chapter from your browser.
  • Help for a single field or menu item. F1 goes by the window, panel or tool.