Hi steinbacherGE,

I have a solution for cross-deliverable (cross-book) links with Oxygen's HTML5-based WebHelp:

https://github.com/chrispy-snps/DITA-fi ... html-links

Feel free to ask any questions!

- Chris

Hi Radu, The picture I had in my head was that the processing stages at https://www.dita-ot.org/dev/reference/preprocessing.html were applied one at a time. And if you made a copy of the working directory between the steps, you'd have a series of snapshot directories that you could diff -- or rerun ...

Hi Lisa, I am currently converting a set of four application notes from Word to DITA. They vary from 50 pages to 300 pages in length. I saved the app notes from Word as "Web Page, Filtered" which is a simplified HTML output. I was then able to write a perl script to read each HTML file and process i...

We use a 3GB default for the transformations that our writers run on their laptops (8GB memory).

My company also uses different formatting for single-step procedures, so it seems like a good enhancement to have.

Hi all, I'd like to learn more about how the DITA-OT works internally, so I can contribute new features and bug fixes back to the project. (In particular, I would like to develop a publishing solution for cross-book links.) I have a very basic knowledge of XSLT. Currently I am hand-making small DITA...

Hi Cosmin, We have still been getting spurious instances of writers checking modified project files into Git. Today I found that changing the following three filtering settings will cause the project file to be modified: image.png Choosing a condition from the condition list does not change the proj...

Here is a check that reminds writers to populate cross-book links with reference text:

Hi Radu,

Is this SVG schema-checking issue resolved in PDF Chemistry?

I've removed DOCTYPE from our existing SVG files, but writers will create new ones over time.

Hi Radu, The problem is that we are trying to avoid having the number of transformation scenarios multiply out like that. For example, consider the following DITAVAL files: filtering: filter_product1.ditaval filter_product2.ditaval filter_product3.ditaval filter_product4.ditaval filter_product5.dita...

Testcase attached!

I am trying to refactor our DITAVAL files into separate filtering and flagging files: $ fgrep 'action="include"' * filter_product1.ditaval: <prop att="product" val="product1" action="include"/> filter_product2.ditaval: <prop att="product" val="product2" action="include"/> $ grep revprop * flag_final...

Hi all, I wanted to start a discussion thread where we can share useful Schematron checks for DITA authoring. Here's a check that reports text elements that begin/end with spaces: <rule context="p|ph|codeph|filename|indexterm|xref|user-defined|user-input" role="warning"> <let name="firstNodeIsElemen...

Oxygen folks - what is the internal issue ID for this enhancement?

Here's an example of how FrameMaker implements this. End of first page:


Beginning of second page:

Hi Julien,

How does this work? Do I create an empty HTML file with just these tags, then apply my book CSS and see how it renders? Or is there a file somewhere that I open and view in Oxygen?

Taking a slight detour for a support question... I noticed that when I insert a <draft-comment> element, it automatically populates the @author attribute. This is pretty cool! I'd like to implement this for a <project-label> specialization, but I can't figure out how it's implemented by looking in t...

catherine wrote: ↑

Tue Mar 17, 2020 11:33 am

For now, I need to change css file then generate PDF file to check the style.
I do this process many times to get the style that I want, it wastes my time.
Any way to improve this process?

Are you running on an empty (or mostly empty) book so it's only publishing the cover?

For the most part, we haven't had problems. We haven't even had very many conflicts, and I have demonstrated the 3-way diff feature on a few occasions. But we have a large writing team, many of them nontechnical. Despite repeated reminders, some go a week or more without doing a Pull, and that has b...

Actually, this seems to be an issue with a particular user's freshly pulled Git repo. When I deleted my own repo and recreated it from Git, the master files were configured as expected. Sorry! Okay, so we figured out when this happens. If you use the Git plugin to clone a repo from the server, the ...

I haven't seen a Git client that automatically pulls from the remote, at least not by default. I don't know if there is a Git client that offers such an option. To be honest, I don't know if this would be a great idea, as it would also bring unwanted changes. Imagine a team member commits something...

Actually, this seems to be an issue with a particular user's freshly pulled Git repo. When I deleted my own repo and recreated it from Git, the master files were configured as expected. Sorry!

Is there a way to store the Master files configuration in the *.xpr project file?

Our project is stored in a Git repo, and each writer gets warned that Master files support is disabled when they open the project for the first time. Then we need to walk them through which files to add.

Hi Radu, I added a new issue with ID EXM-45204. I suspect right now the entries in the combo box might appear in the same order in which the individual context elements appeared in the dita ot project file. Should we try to display them alphabetically? Alphanumerically would be good, just so the use...

Hi Radu, My @rev feature thinking is a complicated feature, and it's asking CCMS-like functionality of an XML editing tool. In the meantime, I have implemented a specialization of <draft-comment> called <project-label>, and we will just set @rev to 1.0: project-label.PNG It has some limitations: It ...

Hi Sorin, Thanks! We are using the Project Level Settings and it helps tremendously in preventing unwanted *.xpr modifications. Unfortunately there are still cases where it gets modified by nosy users or tool behaviors we don't yet understand. I did try the .gitignore approach but it did not solve t...

You are right. This would not be dangerous in our team because writers tend to own different books in their entirety, but a more collaborative project could run into trouble. On another topic, I find that we are still occasionally having issues with writers committing modified *.xpr Oxygen project f...

Hi Carl, Radu and I have had some conversations about "sticky" DITA map contexts. Here is the text from an enhancement request that I filed. We actively employ Eliot Kimber's DITA "best practice" of defining a key for every topic, then using only keyrefs for within-book and cross-book references. Wi...

Hi all, In the new features list for Oxygen XML Author 22.0, I was intrigued by the mention of DITA-OT project files! One mistake I initially made was thinking that this was a new type of Oxygen project file (*.xpr), but it's not; a "DITA-OT project file" is a new feature in DITA-OT 3.4 that allows ...

I should mention that the Revisions topic in the frontmatter serves multiple purposes: Before starting a project, I can scope the work required by placing @rev placeholders in all the topics where I think changes will be needed for that project. While working on a project, I can use the Revisions to...

If I edit the XML directly to set the desired @rev value: <ph rev="TCL-001">To disable this feature, set the <codeph>sh_enable_line_editing</codeph> variable to <codeph>false</codeph> in the setup file.</ph> then Oxygen gives me the following dialog the next time I invoke the profiling conditions di...