结构化写作定义及要求 (结构化写作定义)

本文目录导航：

• 结构化写作定义及要求
• XAP是什么
• 结构化写作之压服他人

结构化写作定义及要求

结构化写作是一种有组织、有规定的文档编写方法，注重经常使用分歧的结构与格局，以提高内容的可读性和易用性。

在结构化写作中，文档内容被宰割为小块、小节，每个局部都有明晰的标题和标识符，便于保养、降级和查找。

经过遵照特定的文档模板和结构，作者可以确保消息的准确传达。

结构化写作常联合规范写作规范与工具，如Markdown+git，简化内容治理流程。

启动结构化写作时，理论遵照以下步骤：1. **确定消息模块类型**：依据指标受众和写作目的，选用适宜的消息模块类型，如形容类（Concept）、环节类（Task）、参考类（Reference）。

2. **定义Topic级内容单元**：布局内容单元的范畴，明白节点称号。

3. **定义Section级内容单元**：设计文档结构，确定标题、段落等元素。

4. **开发技术文档**：从用户视角登程，联合实践经常使用场景编写文档。

结构化写作中，消息模块重要分为：形容类：引见系统或产品的性能、配置、特性、规格等基本消息，适宜制造产品说明书和技术规格书。

环节类：指点用户执行操作、保养和缺点扫除，适用于装置指南、用户手册和操作手册。

参考类：提供技术细节、编程接口、数据结构等详细消息，用于开发人员或技术人员参考，包括API文档和开发者手册。

在结构化写作规范中，Topic作为最小且独立的内容单元，每个单元都有明白的标题和定义。

关于Task Topic，内容模板普通蕴含：task标题：主题形容。

shortdesc：冗长说明。

taskbody：详细内容。

related-links：关系链接。

XAP是什么

探求未来写作新范式：XAP——默认结构化内容的翻新之作

在消息化时代的浪潮中，北京爱福爱特科技有限公司推出的XAP，以其共同的魅力推翻了传统的写作模式。

XAP，全称为结构化写作工具XAP，它以DITA XML技术为外围，从新定义了内容治理的边界。

告别繁琐，拥抱效率

相较于传统的Word等文字编辑工具，XAP采用了XML格局，将文本内容转化为结构化的元素，每一段文字都被赋予特定的标签，使得内容的组织和治理变得愈加头头是道。

这种标签化的处置模式，使得内容的抽取、检索、计算和格局化变得轻而易举，似乎解锁了内容的有限或者。

XAP因此成为默认消息生成、常识图谱构建和交互式电子手册创作的得力助手。

跨言语跨平台，有限裁减

作为一款成熟的结构化写作系统，XAP的一大亮点在于其弱小的同源多言语多格局颁布才干。

无论你要求面向世界的读者，还是顺应各种设施敌对台，XAP都能无缝对接，确保消息的分歧性和分歧性体验。

这使得XAP在泛滥企业中赢得了宽泛的认可和运行，成为推进内容治理迈向现代化的有力引擎。

引领未来，扭转写作模式

总的来说，XAP不只是一个工具，更是翻新写作思想的催化剂。

它经过XML技术，赋予内容结构和逻辑，为高效、默认的内容治理和流传提供了强有力的允许。

在数字化转型的大潮中，XAP无疑为各行业提供了构建和治理常识资产的新门路，让写作步入了一个全新的维度。

结构化写作之压服他人

结构化写作之压服他人压服他人，要求做到三点：指表明白，换位思索和有理有据。

第一步：指表明白 一是用WA方法设定指标，宿愿Who在看完我写的内容后，能够做到achievement（“赞同/认可/采用/接受”我的“观念/倡导/立场/态度”，采取或实施我希冀的“执行/措施/行为”）。

二是依据指标构成观念 你要处置的是什么疑问？ 你想要干什么？目的是什么？ 你预备采取哪些措施？ 预期将取得什么样的成就？ 第二步：换位思索 林肯说：“我会用三分之一的期间来思索自己以及要说的话，花三分之二的期间思索对方以及他会说什么话。

” 一是要学会提问，用“不懂-回答”想象疑问，回答疑问。

薛兆丰教员曾经讲过一个丘吉尔的例子，说丘吉尔在印度当兵的时刻，让他父亲把英国议会的答辩记载寄给他，他先看答辩的标题，先不看答辩的内容，而后自己思索假设是我，我会怎样答辩？而后再去看答辩的内容，看看有哪些没有想到，以此来提高答辩水平。

二是调用5W2H思想模型想象疑问。

普通咱们是用5W1H，多了这个H是how much。

这本书是针对职场写作的，关于钱和老本的疑问，是职场人士必定要思索的内容，表现了本书的适用性。

第三步是有理有据。

着重讲了推理。

一是归结推理。

大前提、小前提、论断。

二是归结推理。

搜集消息、寻觅特性、构成概念。

三是言语要：明晰、明白、详细。

昨天我在上看到了，黄金圈规律，外面就讲到了高手和普通人的差异是：高手是先问why，再说HOW，再讲what。

普通人是先说what，再说HOW，最后才是why，我了解的是甚至没有why。

比如咱们写一个制度，前面都有总则/前言，为什么要写总则，就是why，以前自己不注重总则，认为都是抄抄他人的，其实这个总则是反映了为什么要做这个制度，曾经假设最终要求经常使用“最终解释权”，咱们就要从总则外面的去看看咱们设计这个制度的初心是什么，思索的层面就不一样了。

说回这个黄金圈规律，我发现这本书也默默的合乎了这种规律，每一步的主题，比如“指表明白”“换位思索”“有理有据”，先是WHY，经过案例，词语的含意，来讲为什么要这样做？。

其次才是what做什么？就是我下面重点讲的各种方法。

而后用了HOW，他山之石可以攻玉，讲了学员遇到的实践疑问。

最后IF，深度学习离不开独立思索，给读者出思索题，让读者去思索这里提的疑问，从而加深了解。

整个why-what-how-if的线条明晰明白，暗合了黄金圈规律。

GYL（土豆番茄青蛙） 2019年3月31日