- 博客(174)
- 资源 (1)
- 收藏
- 关注
原创 在Oxygen编辑器中使用DeepSeek
Oxygen编辑器是罗马尼亚研发的文档编辑器,国内资料开发团队用得很多;DeepSeek是国产大模型,怎样让他们结合就是今年我在tcworld大会上给大家的分享。
2025-06-03 09:39:14
861
原创 上海工作机会:Technical Writer & Senior Technical Writer - 中微半导体设备
公司自主研制出国内第一台电介质刻蚀机,开发的包括十几种细分刻蚀设备已可以覆盖大多数的刻蚀应用,产品被广泛应用于国内和国际一线客户,技术覆盖65到5纳米及更先进工艺。中微总部位于上海,聚焦亚洲,并为全球的客户提供技术和设备的解决方案。作为制造和创新的中心,中国和亚洲具有得天独厚的优势和高速成长的市场,而这使中微有无限广阔的发展前景。中微半导体设备(上海)股份有限公司(证券简称“中微公司”)成立于2004年,2019年在科创板上市,现已发展成为国内高端微观加工设备的领军企业之一。
2025-06-01 11:47:58
701
原创 明天tcworld China大会见!
5月22-23日,tcworld China 2025将在上海苏宁环球万怡酒店举行。《大龙谈智能内容》公众号是tcworld China 2025的合作伙伴,以上是公众号的logo,大家喜欢吗?如果有想去但是还没有来得急购票的朋友(1天2天的票都可以),购票时输入优惠码 "dalongtalk2025" 即可享受 300 元的专属优惠。购票链接:https://www.tcworld-china.cn/ticket/
2025-05-21 16:49:55
209
原创 厉害的产品经理这样通过文档团队降低客户支持工作量
摩拿科技是专业的结构化文档工具和服务提供商,我们在标准软件(如:Oxygen XML Editor, MxDoc)的基础上提供专业服务,协助企业文档结构化转型落地,欢迎。和许多同行一样,这位产品经理曾深陷泥潭:利益相关者的需求、无尽的deadline和混乱的文档管理让每次发布都充满混乱。首席文档工程师的反馈直接带来了更高的用户采用率和更少投诉。让文档团队早期介入不仅是文档策略,更是赋能团队、交付用户喜爱产品的关键。更清晰的文档让用户能快速找到答案,带来客户支持的工单减少。无需临时赶工,所有材料按时就位。
2025-04-18 09:08:13
357
原创 工程领域最大的误区:“我们不需要技术文档工程师,我们的工程师可以自己写”
摩拿科技是专业的结构化文档工具和服务提供商,我们在标准软件(如:Oxygen XML Editor, MxDoc)的基础上提供专业服务,协助企业文档结构化转型落地,欢迎。直到他们请来专业文档工程师,重写的文档清晰准确,终稿零修改意见。"我们不需要技术文档工程师,我们的工程师可以自己写"让我们共同停止把"文档编写"与"信息堆砌"混为一谈。某项目曾为"节省成本"让工程师兼职写文档。↳ 优秀工程师 ≠ 优秀文档撰写者。↳ 文档低劣 = 高昂的支持成本。✅ 文档工程师是技术翻译。二者结合方能产出有效成果。
2025-04-11 09:52:00
199
原创 记一次为用户查找DITA手册发布失败原因的过程
1有用户在将DITA手册发布成MS Word过程中,出现发布失败的情况。Oxygen提示错误信息,如下:双击错误后,打开的文件定位不到具体的错误,并且不能明显地看出是什么问题。用户等着将生成的Word文件给客户,相当着急。赶紧联系摩拿,请求协助分析失败原因并解决发布失败的问题。
2025-04-01 11:46:36
711
原创 卓越的用户体验需要智能内容
这篇文章指出静态文档已无法满足现代用户的需求,而智能内容则是构建卓越用户体验的关键。文章从智能内容的定义、优势和实际应用等方面进行了详细阐述,并强调了企业应积极拥抱智能内容,以提升客户满意度、降低成本并创造新的收入来源。
2025-03-17 13:54:00
826
原创 SAP如何使用DITA-OT搭建每天6万输出的大型文档生产基础设施
SAP公司的Youssef在2016年DITA-OT慕尼黑大会上分享了题为《Large Scale Production Using Project Maps》的文章。此文以介绍SAP的DITA使用情况和怎样使用DITA-OT构建一个每天生成超过6万分输出内容的大规模生产基础设施。
2025-03-05 11:26:32
896
原创 大龙谈智能内容的2024
2024年人工智能进展迅猛,咱们也与时俱进。今年我不再手工做年度总结了,而是让人工智能帮我总结一下2024年《大龙谈智能内容》公众号的内容。
2025-02-17 14:36:44
811
原创 恩智浦:将开发文档迁移到DITA/XML
本文是德国同行Parson公司写的一篇文章,描述芯片巨头恩智浦编写文档方法如何从MS Word和Adobe Frame Maker转向基于DITA的结构化写作和发布。
2025-02-13 14:30:19
759
原创 上手DeepSeek大模型:本地化安装部署,确保数据不泄露
过年前DeepSeek横空出世,在世界范围内掀起AI狂潮,成了大家茶余饭后的话题。对于普通人怎样使用这个大模型呢?这篇文章来上手实践。
2025-02-01 12:06:20
4052
原创 使用Oxygen编辑文档时,表格报错怎么解决?
此列的问题是第2列其实想合并第2列和第3列,错误地写成了合并第2列到第4列。DITA中的表格有两种:table和simpletable,其中table功能更强大(比如支持行合并或者列合并),用得更多一些。这个示例展示了一个包含三列和两行数据的简单表格,以及一个标题行。表格总共是有4列, 但是在表头的第一行中它有5列:第一列是独立的一列;图中15行,其中namest和nameend属性分别表示要合并的列的开始列名称和结束列名称。其中的table用了CALS表格模型,它是一种在XML中表示表格信息的标准方式。
2025-01-13 09:51:48
391
原创 还有飞书文档覆盖不了的场景?聊聊DITA文档标准适合哪些类型的企业
不管是生产实实在在东西的公司,比如汽车、冰箱、电脑芯片这些,还是做软件这种看不见摸不着的公司,都能用得上DITA。这些东西都有自己的型号,需要详细记录,而这类公司就可以用DITA来更好地管理它们的产品文档。而在DITA中除了这些通用的东西以外,还可以有通知、件号、单价、类型这些特定含义的信息。不仅可以生成方便用手机、电脑看的文档,还生成定制的PDF文件,Word文件,想打印出来或者在线分享都很方便。总之,不管你是做硬件产品还是软件产品,只要你需要写复杂的技术文档,DITA都能帮你更好地组织和发布文档。
2024-09-23 08:58:41
387
原创 企业中文档团队的三种组织形式
就是说,公司里头有几个不同的部门,每个部门都需要做文档。于是呢,公司就专门成立了个文档组,这组人就像个万能钥匙,哪儿需要就往哪儿钻,帮各部门搞定文档的事儿。平时,研发那边会给他们提供一些资料,他们再把这些资料整理成文档,最后还得让研发的人过目一下,确保内容没错才能正式发布。这个模式下,每个部门都有自己的文档专员,这些专员就跟研发的小伙伴们并肩作战,专攻自家部门的文档任务。还是那些部门,还是那些文档需求,不过这次公司设立的是一个文档支持小组。这就是我了解到的三种文档团队组织形式,你们公司用的是哪种模式呢?
2024-09-20 11:46:49
295
原创 流程文档:构建高效业务流程的详细指南
流程文档是创建完成特定业务项目所涉及的文档化流程的行为。本文档概述了流程从开始到结束的工作方式,确保所有团队成员都清楚地了解工作流。
2024-08-21 10:47:18
2448
原创 产品文档全攻略:分类、价值及创建技巧
系统文档的技术部分针对的是技术含量很高的受众,如研究人员和工程师。:产品需求文档等文档是在对市场进行了大量研究并得到所有产品团队的输入后开发的。无论他们是使用你的产品的新手还是行业专家,都要调整相关的语气,使你的作品对产品面向的任何受众都是可读的。对于开发产品的后续版本的工程师来说,架构也是一个宝贵的资源。文档增强了产品的价值,并列出了产品的使用方式。一份详细的指南,其中包括使用产品的完整方法,也很好地发挥了其在营销中的作用。文档是对产品的补充。使用特定产品的详细指南可以建立用户使用您的品牌和产品的信心。
2024-08-16 11:02:29
1311
原创 DITA发布MS Word样式定制
结构化文档能输出可编辑的Word格式,不过Oxygen/DITA-OT默认的DITA发布Word输出太过于基础,经过样式定制以后看看输出的word长啥样。
2024-08-08 10:01:37
1228
1
原创 DITA的优点和缺点
原文链接:https://stefan-jung.org/dita-introduction/DITA的实施可能是一项复杂的任务,本节列出了在实施DITA之前需要了解它的优缺点。如果不购买像Oxygen XML Editor这样的编辑器,难以真正用起来。强大的功能(内容重用、变量、关系表、键作用域、过滤器)可扩展,可以从文件系统开始,稍后迁移到企业CMS。用于DITA内容的发布工具DITA-OT是开源的。可以与版本控制系统一起使用,比如:Git。是基于XML的,需要了解XML。难以定制文档类型(专业化)
2024-08-01 09:44:12
525
原创 什么样的公司适合用DITA方法写产品文档
这些公司创造现实世界的实物产品,如汽车、冰箱或计算机芯片。每个产品的每个版本都有一个唯一的产品ID,需要记录下来。不同的产品有时在功能上相似,但也有一些差异。这些公司提供版本化的软件组件,通常安装在客户端。由于每个客户可能都有旧版本的产品,因此需要提供旧版本的用户手册。这些公司通常提供基于云的服务(SaaS),最终用户始终可以访问最新的稳定版本,并且没有为过去的版本提供用户手册。作者 | Radu Coravu。
2024-07-31 09:14:19
541
原创 结构化写作的好处:省去排版工作并让文档风格一致
结构化写作是编写技术文档的一种标准化方法,其中内容由预定义的规则控制。结构化写作的思想和Word不同,结构化写作中内容和样式(或者叫做视觉效果)是分开的。写作时不用关心输出是怎样的,也不用进行排版,只专心于内容创作本身。样式文件是针对各种情形提供统一的格式化方案,而不是针对每一个文件的每一处进行特殊处理,这就能保证输出统一风格的文档。所有人都使用同样的样式文件,这样能得到风格一致的输出物(PDF)。传统是使用文档模板来辅助人们按照一定的规则写作,不过它不是强制的,也无法检查内容是否符合某个规则。
2024-07-30 09:31:21
715
原创 如何写好技术文档 - 来自Google十多年的文档经验
写文档有一个很常见的错误,那就是很多人文档都是写给自己看的,这种情况下就会导致你的文档只有自己或者和你有相似知识背景的人才能看懂,团队较小时这种问题还好,你们都做着类似的工作,所以也都能看懂文档。虽然很多工程师都讨厌冗余 极力追求简洁,但写文档和写代码不同,适当的冗余反而可以帮助读者理解,很简单,举个例子,比如写作中经常举例子,举的例子本质上就是冗余信息,生动的例子肯定是能帮助读者理解抽象内容的(我想这就是自举吧)。:一般由团队里比较资深的人负责,他们关注的核心点是文档写的对不对,专不专业。
2024-07-27 12:09:33
1587
原创 Google文档工程师:我们代表用户在产品研发中发声
这是一次非常令人大开眼界的经历,和不同语言的人一起工作,不同的文化不同的背景,真正努力确保我们正确地将谷歌的产品信息发送给所有这些不同受众,并确保我们产生最大的影响。这不仅仅是在线帮助,它也可以是用户指南教程,视频培训,UI中的错误消息。我正在交付用户他们需要知道的信息,我们真的很想帮助我们的最终用户,对我们的产品有最好的体验。确保我们正在将谷歌的产品正确信息发送给所有这些不同的观众,并确保我们产生最大的影响。Hi, 我是Matt Werner,我是谷歌的一名技术作家。我叫佩吉,我是谷歌的一名技术作家。
2024-07-08 13:59:24
215
原创 如何为转DITA写作准备和培训团队
在刚刚结束的Adobe DITA World 2024大会上,Amanda博士做了《为DITA写作准备和培训团队》的分享
2024-06-24 18:23:52
363
原创 在线的、完全免费的、提供回放的技术传播方面的大会:Adobe DITA World 2024
全球最大的DITA营销和技术传播认识在线会议正在举行
2024-06-13 13:27:16
223
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人