|
所在平台: Udemy |
课程主页: https://www.udemy.com/course/technical-writing-common-dita-xml-map-and-topic-elements/
课程评论:没有评论
课程名称:技术写作:常见的DITA XML地图和主题元素 课程概述: 在学习DITA XML技术写作时,你是否感到困惑和不知所措,因为需要掌握的元素太多?你是否想知道哪些元素必须使用,以快速编写软件文档?本课程正是为你而设!如果你是一名技术写作人员,希望提升与DITA XML相关的知识和技能,那么了解DITA XML地图和主题元素至关重要。由JPDocu技术写作学校提供的本课程,由财富500强软件开发公司的用户帮助开发架构师Jordan Stanchev讲授,他将分享关于DITA XML和Oxygen XML Author的丰富知识。 本课程解决了DITA XML作者面临的一个主要挑战:开始写作前需要学习的元素数量庞大。现在在OASIS中正在进行的项目旨在简化和减少可用元素数量(轻量级DITA XML项目),但这真的有必要吗?面对更复杂的文档场景时,它会有所帮助吗? 若你是一名DITA XML技术写作人员,了解DITA 1.3规范中最常用的元素是非常重要的。这些知识的掌握将使你能够编写所需文档,同时不放弃DITA的任何好处和功能。 学习内容包括: 1. 介绍及工具安装(10分钟) - 如何开始使用DITA XML写作。指导下载和安装最佳的DITA XML编辑器:Oxygen XML Author。 2. DITA XML元素(45分钟) - 了解常用的DITA XML地图元素来组织内容结构。包括:mapref、navref、topicref和topichead等元素的使用及示例演示。 3. DITA XML主题及主题元素(1小时25分钟) - DITA是一种语义语言,遵循极简主义和基于主题的结构化写作原则。常用的主题类型包括:任务(Task)、概念(Concept)和参考(Reference)。重点关注任务类型,学习如何有效结构化和编写内容,包括表格和章节元素的具体应用。 课程中还包括实际操作练习,帮助你快速上手,提高DITA XML写作技能。 注意:本课程不是DITA XML元素的完整详尽列表。由于DITA中元素的复杂性,我们旨在简化学习过程,让你迅速入门,而非覆盖所有可能的DITA方面。快来尝试,提升你的DITA XML写作技能吧!记住,技术写作其实很简单——毕竟,这只是简单的文档!
Are you confused and overwhelmed by the number of elements you need to learn as a DITA XML technical writer? Do you wonder which are the elements you must use to simply write your software documentation fast? Or you simply need a refresher on which are the most often used elements in DITA XML?If yes, this course is for you! If you are a technical writer, looking to improve your knowledge and skills related to DITA XML, you should know the DITA XML map and topic elements well. JPDocu School of Technical Writing has providing instructor-led and self-paced courses on technical writing, DITA XML, and information architecture to thousands of students worldwide. In this course, Jordan Stanchev, User Assistance Development Architect at a Fortune 500 software development company, is sharing his vast knowledge in DITA XML and Oxygen XML Author.One of the major challenges authors have with DITA XML is the sheer amount of elements that you have to learn just to start writing. There are currently initiatives happening in the OASIS compete that define the DITA standard to simplify and reduce the number of elements you can use (Lightweight DITA XML project). But is that really needed? Will it help you when you have a more complex scenario to document?If you are a DITA XML technical writer, you should know the most frequently and commonly used DITA XML elements from DITA 1.3 specification. The consequence of having this knowledge will be that you should be able to write the documentation you need without giving up on any benefits and functionality of DITA. In this course, you will learn:Introduction & Installing the Tool for Writing - 10 minHow to get started writing in DITA XML. You will follow the steps to download and install one of the best DITA XML editors - Oxygen XML Author. DITA XML Elements - 45 minWhich are the DITA XML map elements that you would use frequently to organize the structure of your content? You will need:mapref to reference one DITA XML map to another;navref to switch the writing context between deliverables;topicref to structure and organize your topics;topichead to create a title to group together content underneath it.This followed by a demo on how to use all these elements in an end-to-end scenario.DITA XML Topics and Topic Elements - 1 hour 25 minDITA is a semantic language. It follows the principles of minimalism and structured topic-based writing. You will understand the most frequently used DITA XML topic types: Task, Concept, and Reference.I would dare to say that Task is the most important template for writing for a technical writer. It focuses on properly structuring and writing the content of each instruction you write.You will see also specifics around more tricky DITA XML topic elements - such as the table and section elements, that help you better organize your documentation. This all followed by a demo on how to use each of these elements.You will perform short and straight-to-the-point exercises following the instructor's step-by-step demos.What is not included in this course?This is not a complete and exhaustive list of DITA XML elements. One of the most complicated aspects of DITA is related to the way-too-many elements that are available. In this course, we try to simplify it to help you get started quickly, instead of trying to cover every possible DITA aspect.Try it out and up your DITA XML writing skills! Remember, technical writing is easy - after all, it is just plain docu!