diff --git a/Readme/Writerside/images/completion_procedure.png b/Readme/Writerside/images/completion_procedure.png new file mode 100644 index 0000000..3535a3f Binary files /dev/null and b/Readme/Writerside/images/completion_procedure.png differ diff --git a/Readme/Writerside/images/completion_procedure_dark.png b/Readme/Writerside/images/completion_procedure_dark.png new file mode 100644 index 0000000..a65beb0 Binary files /dev/null and b/Readme/Writerside/images/completion_procedure_dark.png differ diff --git a/Readme/Writerside/images/convert_table_to_xml.png b/Readme/Writerside/images/convert_table_to_xml.png new file mode 100644 index 0000000..2518a64 Binary files /dev/null and b/Readme/Writerside/images/convert_table_to_xml.png differ diff --git a/Readme/Writerside/images/convert_table_to_xml_dark.png b/Readme/Writerside/images/convert_table_to_xml_dark.png new file mode 100644 index 0000000..4716122 Binary files /dev/null and b/Readme/Writerside/images/convert_table_to_xml_dark.png differ diff --git a/Readme/Writerside/images/new_topic_options.png b/Readme/Writerside/images/new_topic_options.png new file mode 100644 index 0000000..bc6abb6 Binary files /dev/null and b/Readme/Writerside/images/new_topic_options.png differ diff --git a/Readme/Writerside/images/new_topic_options_dark.png b/Readme/Writerside/images/new_topic_options_dark.png new file mode 100644 index 0000000..bf3e48d Binary files /dev/null and b/Readme/Writerside/images/new_topic_options_dark.png differ diff --git a/Readme/Writerside/in.tree b/Readme/Writerside/in.tree new file mode 100644 index 0000000..4931866 --- /dev/null +++ b/Readme/Writerside/in.tree @@ -0,0 +1,10 @@ + + + + + + + \ No newline at end of file diff --git a/Readme/Writerside/topics/starter.md b/Readme/Writerside/topics/starter.md new file mode 100644 index 0000000..6471a44 --- /dev/null +++ b/Readme/Writerside/topics/starter.md @@ -0,0 +1,79 @@ +# Starter + + + +## Add new topics +You can create empty topics, or choose a template for different types of content that contains some boilerplate structure to help you get started: + +![Create new topic options](new_topic_options.png){ width=290 }{border-effect=line} + +## Write content +%product% supports two types of markup: Markdown and XML. +When you create a new help article, you can choose between two topic types, but this doesn't mean you have to stick to a single format. +You can author content in Markdown and extend it with semantic attributes or inject entire XML elements. + +## Inject XML +For example, this is how you inject a procedure: + + + +

Start typing and select a procedure type from the completion suggestions:

+ completion suggestions for procedure +
+ +

Press Tab or Enter to insert the markup.

+
+
+ +## Add interactive elements + +### Tabs +To add switchable content, you can make use of tabs (inject them by starting to type `tab` on a new line): + + + + ![Alt Text](new_topic_options.png){ width=450 } + + + + ]]> + + + +### Collapsible blocks +Apart from injecting entire XML elements, you can use attributes to configure the behavior of certain elements. +For example, you can collapse a chapter that contains non-essential information: + +#### Supplementary info {collapsible="true"} +Content under a collapsible header will be collapsed by default, +but you can modify the behavior by adding the following attribute: +`default-state="expanded"` + +### Convert selection to XML +If you need to extend an element with more functions, you can convert selected content from Markdown to semantic markup. +For example, if you want to merge cells in a table, it's much easier to convert it to XML than do this in Markdown. +Position the caret anywhere in the table and press Alt+Enter: + +Convert table to XML + +## Feedback and support +Please report any issues, usability improvements, or feature requests to our +YouTrack project +(you will need to register). + +You are welcome to join our +public Slack workspace. +Before you do, please read our [Code of conduct](https://plugins.jetbrains.com/plugin/20158-writerside/docs/writerside-code-of-conduct.html). +We assume that you’ve read and acknowledged it before joining. + +You can also always email us at [writerside@jetbrains.com](mailto:writerside@jetbrains.com). + + + + Markup reference + Reorder topics in the TOC + Build and publish + Configure Search + + \ No newline at end of file