3/20/2023 0 Comments Oxygen xml editor args.filter![]() If you want to use the same topic in different DITA maps, you just reference that topic again in another map.īut you may not want to create separate maps, because more maps means more maintenance and updates. ![]() Your DITA map consists of a list of references to topics. When re-using content, there are several techniques to consider: You'll need to make content adjustments for the differing brands and models. There is 70% similarity of content between the six manuals. Both have similar seat stems, but the Trek is fastened via a bolt while the Fisher is fastened with quick release, and so on. Both have the same tires and wheels, but the Fisher has a different spoke size. There are some variations between the topics, sometimes as trivial as simple name changes, other times more substantial, such as entirely different processes.įor example, while the Trek and Fisher bikes both have Shimano brakes and derailleurs, the Fisher bikes have different cranks and pedals than the Trek cranks and pedals. There are approximately 30 sections in your manual, with topics such as maintaining brakes, adjusting handlebars, tightening bottom brackets, greasing chains, adjusting spokes, and so on. So in total, you have six manuals to produce from roughly the same content. There are three Gary Fisher bike models: City Slicker 2.0, City Slicker 2.1, and City Slicker 2.2. The parts are mostly the same for the Gary Fisher and Trek bikes, except the parts for the Fisher bikes are rebranded with the Gary Fisher brand. Additionally, the same parts you're documenting are also pushed into another brand: Gary Fisher. Suppose you're creating an online manual for a Trek 7.1 FX, 7.2 FX, and 7.3 FX model bike. I'll repeat the scenario here because the content re-use strategies I'm using are formulated based on this situation. I described the scenario for content re-use in my previous post. In this post, I explain how to do content re-use with DITA and Oxygen. Content re-use with DITA is much more robust, precise, and just works. XML allows you to re-use content in easier ways. I'm still working on the proof of concept, but it looks promising. If you make the site anonymous and create several sites (one for each product), you can't reuse the same content easily across the different sites.īecause of these issues, I've ditched Confluence and am hoping to officially adopt an XML solution using OxygenXML as the editor. That's a lot of individual user management. If you only want certain groups to see certain content, you have to individually manage their access to those spaces (and each logged-in user counts against your licensing costs). The paradigm is that all content is on one site, grouped into different spaces. ![]() The real deal-killer with Confluence is managing access control. While I initially thought Confluence would simplify authoring and allow me to focus more on content, the primitive re-use capabilities actually make help authoring more tedious and time consuming. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |