Compare commits
2 Commits
152e08d47b
...
0c85027608
Author | SHA1 | Date |
---|---|---|
杨明 | 0c85027608 | |
杨明 | 94dd9b065b |
|
@ -4,7 +4,9 @@
|
||||||
|
|
||||||
<instance-profile id="hi"
|
<instance-profile id="hi"
|
||||||
name="Help Instance"
|
name="Help Instance"
|
||||||
start-page="Default-topic.md">
|
start-page="Autolabor-M1.md">
|
||||||
|
|
||||||
<toc-element topic="Default-topic.md"/>
|
<toc-element topic="Autolabor-M1.md">
|
||||||
|
<toc-element topic="收货指南.md"/>
|
||||||
|
</toc-element>
|
||||||
</instance-profile>
|
</instance-profile>
|
|
@ -0,0 +1,17 @@
|
||||||
|
<?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>
|
|
@ -0,0 +1,3 @@
|
||||||
|
# Autolabor M1
|
||||||
|
|
||||||
|
Start typing here...
|
|
@ -1,79 +0,0 @@
|
||||||
# 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>
|
|
|
@ -0,0 +1,3 @@
|
||||||
|
# 收货指南
|
||||||
|
|
||||||
|
Start typing here...
|
Loading…
Reference in New Issue