Compare commits
No commits in common. "0c850276081ab80ddc281ee3018993786ba1dba3" and "152e08d47baac769377b258584185380d63cb920" have entirely different histories.
0c85027608
...
152e08d47b
|
@ -4,9 +4,7 @@
|
||||||
|
|
||||||
<instance-profile id="hi"
|
<instance-profile id="hi"
|
||||||
name="Help Instance"
|
name="Help Instance"
|
||||||
start-page="Autolabor-M1.md">
|
start-page="Default-topic.md">
|
||||||
|
|
||||||
<toc-element topic="Autolabor-M1.md">
|
<toc-element topic="Default-topic.md"/>
|
||||||
<toc-element topic="收货指南.md"/>
|
|
||||||
</toc-element>
|
|
||||||
</instance-profile>
|
</instance-profile>
|
|
@ -1,17 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE rules SYSTEM "https://resources.jetbrains.com/writerside/1.0/redirection-rules.dtd">
|
|
||||||
<rules>
|
|
||||||
<!-- format is as follows
|
|
||||||
<rule id="<unique id>">
|
|
||||||
<accepts>page.html</accepts>
|
|
||||||
</rule>
|
|
||||||
-->
|
|
||||||
<rule id="389d6c16">
|
|
||||||
<description>Created after removal of "Starter" from Help Instance</description>
|
|
||||||
<accepts>Starter.html</accepts>
|
|
||||||
</rule>
|
|
||||||
<rule id="52e60d6d">
|
|
||||||
<description>Created after removal of "This is the first topic" from Help Instance</description>
|
|
||||||
<accepts>Default-topic.html</accepts>
|
|
||||||
</rule>
|
|
||||||
</rules>
|
|
|
@ -1,3 +0,0 @@
|
||||||
# Autolabor M1
|
|
||||||
|
|
||||||
Start typing here...
|
|
|
@ -0,0 +1,79 @@
|
||||||
|
# This is the first topic
|
||||||
|
|
||||||
|
<!--Writerside adds this topic when you create a new documentation project.
|
||||||
|
You can use it as a sandbox to play with Writerside features, and remove it from the TOC when you don't need it anymore.
|
||||||
|
If you want to re-add it for your experiments, click + to create a new topic, choose Topic from Template, and select the
|
||||||
|
"Starter" template.-->
|
||||||
|
|
||||||
|
## 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){ border-effect="line" thumbnail="true" width="321"}
|
||||||
|
|
||||||
|
## 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.
|
||||||
|
|
||||||
|
For example, this is how you inject a procedure:
|
||||||
|
|
||||||
|
<procedure title="Inject a procedure" id="inject-a-procedure">
|
||||||
|
<step>
|
||||||
|
<p>Start typing <code>procedure</code> and select a procedure type from the completion suggestions:</p>
|
||||||
|
<img src="completion_procedure.png" alt="completion suggestions for procedure" border-effect="line"/>
|
||||||
|
</step>
|
||||||
|
<step>
|
||||||
|
<p>Press <shortcut>Tab</shortcut> or <shortcut>Enter</shortcut> to insert the markup.</p>
|
||||||
|
</step>
|
||||||
|
</procedure>
|
||||||
|
|
||||||
|
## Add interactive elements
|
||||||
|
|
||||||
|
### Tabs
|
||||||
|
To add switchable content, use tabs (start typing `tabs` on a new line).
|
||||||
|
|
||||||
|
<tabs>
|
||||||
|
<tab title="Markdown">
|
||||||
|
<code-block lang="plain text">![Alt Text](new_topic_options.png){ width=450 }</code-block>
|
||||||
|
</tab>
|
||||||
|
<tab title="Semantic markup">
|
||||||
|
<code-block lang="xml">
|
||||||
|
<![CDATA[<img src="new_topic_options.png" alt="Alt text" width="450px"/>]]></code-block>
|
||||||
|
</tab>
|
||||||
|
</tabs>
|
||||||
|
|
||||||
|
### Collapsible blocks
|
||||||
|
Besides 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 like this:
|
||||||
|
|
||||||
|
#### Supplementary info {collapsible="true"}
|
||||||
|
Content under such 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 <shortcut>Alt+Enter</shortcut>:
|
||||||
|
|
||||||
|
<img src="convert_table_to_xml.png" alt="Convert table to XML" width="706" border-effect="line"/>
|
||||||
|
|
||||||
|
## Feedback and support
|
||||||
|
Please report any issues, usability improvements, or feature requests to our
|
||||||
|
<a href="https://youtrack.jetbrains.com/newIssue?project=WRS">YouTrack project</a>
|
||||||
|
(you will need to register).
|
||||||
|
|
||||||
|
You are welcome to join our
|
||||||
|
<a href="https://jb.gg/WRS_Slack">public Slack workspace</a>.
|
||||||
|
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).
|
||||||
|
|
||||||
|
<seealso>
|
||||||
|
<category ref="wrs">
|
||||||
|
<a href="https://plugins.jetbrains.com/plugin/20158-writerside/docs/markup-reference.html">Markup reference</a>
|
||||||
|
<a href="https://plugins.jetbrains.com/plugin/20158-writerside/docs/manage-table-of-contents.html">Reorder topics in the TOC</a>
|
||||||
|
<a href="https://plugins.jetbrains.com/plugin/20158-writerside/docs/local-build.html">Build and publish</a>
|
||||||
|
<a href="https://plugins.jetbrains.com/plugin/20158-writerside/docs/configure-search.html">Configure Search</a>
|
||||||
|
</category>
|
||||||
|
</seealso>
|
|
@ -1,3 +0,0 @@
|
||||||
# 收货指南
|
|
||||||
|
|
||||||
Start typing here...
|
|
Loading…
Reference in New Issue