Re: MathML Rendering for PDF

Mica Semrick

If you're willing to go DITA > HTML > PDF, then you should consider PDF Reactor with the MathJax library.

Bonus that PDF Reactor's support is quick to reply.

-m

On March 5, 2021 12:54:46 PM PST, Bill Burns <bb@...> wrote:
Greetings,

We are working with a client to migrate their PDF plugin to DITA-OT 3.6. They have some pretty complex equations, so we’re not sure that Antenna House MathML support is sufficient. Any recommendations for rendering complex MathML equations in PDF transforms?

Thanks,
--
Bill Burns
512-646-2100
--
We are [A]

MathML Rendering for PDF

Bill Burns

Greetings,

We are working with a client to migrate their PDF plugin to DITA-OT 3.6. They have some pretty complex equations, so we’re not sure that Antenna House MathML support is sufficient. Any recommendations for rendering complex MathML equations in PDF transforms?

Thanks,
--
Bill Burns
512-646-2100
--
We are [A]

[ANN] Release of XMLmind XML Editor v9.5

Hussein Shafie

Release of XMLmind XML Editor v9.5: Highlights:

- New "Bidi Support" add-on, which adds bidirectional script support (e.g. Arabic, Hebrew) to XMLmind XML Editor. Not installed by default. If needed, install it using "Options|Install Add-ons".

- More information "XMLmind XML Editor - Bidirectional Script Support", http://www.xmlmind.com/xmleditor/_distrib/doc/bidi/index.html . Corresponding screencast on YouTube: https://youtu.be/8n3LSGAKlEQ .

- Reorganized and improved the View menu. Moreover, the view settings of the document being edited are now automatically made persistent across editing sessions.

- Updated many software components (ditac, Saxon, Batik, FOP, etc).

- XMLmind XML Editor is now officially supported on Java™ 15 platforms and on macOS Big Sur (version 11.0).

--------------------------------------------------
What is XMLmind XML Editor?

Personal Edition is free to use by many persons and organizations. Download:

--------------------------------------------------

[Ann] Oxygen XML Editor version 23.1, Oxygen Feedback version 1.4, and Oxygen Content Fusion version 4.0 are available!

alin_belu@...

Hello everyone,

The Oxygen team is proud to announce the immediate availability of version 23.1 of its industry-leading XML editing suite of products, Oxygen XML Editor, Author, Developer, Web Author, WebHelp, PDF Chemistry, and Oxygen Publishing Engine, along with version 1.4 of the Oxygen Feedback comment management platform, and version 4.0 of the Oxygen Content Fusion collaboration platform.

This release introduces new features such as concurrent editing and reviewing in Oxygen Content Fusion for streamlining your team's collaboration process, the ability to ignore validation problems using Quick Fix actions to filter errors and warnings, and the new block-level comments functionality in Oxygen Feedback allows your users to add and manage comments contextually at a specific location within the WebHelp page. Also, an updated Oxygen Styles Basket, a free web-based visual tool, helps you fine-tune the CSS file that is used to customize PDF or WebHelp output by picking and mixing pre-defined aspects from galleries.

=============================================================================

Version 23.1 of Oxygen XML Editor expands upon the substantial list of features that were recently added in Version 23.0 with further improvements, along with various brand-new enhancements, fixes, and updates.

Dealing with errors and warnings is easier now with the new functionality that allows you to ignore validation problems using Quick Fix actions available in various places where the validation issues are presented.

DITA users benefit from reduced publishing times as the result of an update to the DITA-OT engine to version 3.6, a new refactoring action that generates unique IDs for specified elements, and the DITA to PDF transformation can now display SVG syntax diagrams in the PDF output.

On the development side, the JSON Schema Documentation Generator tool was enhanced with new filtering options, syntax highlights, and options for splitting the output into multiple files or showing the location of the source schema. A specialized YAML editor was added with various editing features including automatic validation, batch validation, syntax highlights, automatic indenting, tools for converting between YAML and JSON, and more. Various updates and improvements were also integrated for users working with XSLT, XQuery, HTML, and CSS.

The SharePoint integration in Oxygen (available in the Enterprise edition only) was redesigned to use the SharePoint REST API v2 to offer authentication using the OAuth protocol. This means that you now have access to a new SharePoint Online type of connection, the various UI components that display the connection details (SharePoint Browser View, Data Source Explorer View, and the Browse for Remote File mechanism in the Open URL dialog box) were redesigned for better consistency and productivity, and quick actions were added in the SharePoint Browser View to make it easier to connect.

Some of the most popular Oxygen add-ons continued to be improved. The Git Client add-on is even more robust with additional actions and options, as well as various UI and performance enhancements. Various new conversion possibilities were added in the Batch Converter add-on (e.g. convert between JSON and YAML or convert multiple Markdown/HTML headings into DITA maps with referenced topics), while the DITA References view add-on and the Oxygen Emmet Plugin received various improvements, and the XSpec Helper view add-on was updated.

Other highlights for this version include improvements to the shortcuts, as they can now be assigned to show side-views contributed by plugins, editor variables can now be resolved in project resources created from a project template, and as always, this release includes new API methods, various bug fixes, and component updates.

=============================================================================

Some functionality available in Oxygen was made available for automation outside of Oxygen (for example, in a continuous integration server) using a separate Oxygen Scripting license.

Starting with version 23.1, you can take advantage of new command-line scripts for comparing files or directories and for executing XML refactoring operations. Also, the Batch Converter script now supports converting between JSON and YAML and various arguments were added to existing scripts to offer even more configuration options.

=============================================================================

Version 23.1 of Oxygen Publishing Engine bundles the latest Oxygen PDF Chemistry and Oxygen XML WebHelp together with the DITA-OT used by Oxygen.

Oxygen PDF Chemistry received further enhancements, such as more details about warning and error messages to assist with debugging, additional support was included for some requested CSS properties along with the addition of new parameters to help fine-tune customizations, and the memory footprint was optimized to provide better performance.

Oxygen XML WebHelp offers new transformation parameters and HTML fragment placeholder parameters to open up a myriad of additional possibilities for customizing the look and style of your output, redesigned renderings of the various types of DITA <note> elements, the ability to add a component in your WebHelp output that links to a PDF resource, and various bug fixes and component updates.

=============================================================================

Version 1.4 of Oxygen Feedback brings you more exciting features for the modern comment management platform that provides a simple and efficient way for your community to interact and offer feedback.

The most interesting new feature added in this version is the ability for your users to add and manage comments contextually at a specific location within the output page where block elements appear, without having to scroll to the comments area at bottom of the page. The Block-Level Comments feature forms a flexible review solution when coupled with the Oxygen XML WebHelp and the Oxygen XML Editor/Author integration through the Feedback Comments Manager plugin, which makes it easy to locate the exact source content referenced by a particular comment and streamlines the process of making changes to the source document in response to the provided comments.

Both Cloud and Enterprise editions also include other productivity improvements, bug fixes, and customization options.

=============================================================================

Version 23.1.0 of Oxygen XML Web Author offers some enhancements to features added in the past few major releases of the dynamic web-based XML authoring tool.

Some of the highlights include the Outline Pane that now displays the entire content of a DITA map when it is opened with all of the referenced topics expanded/editable in one document, optimized performance of the visual editor for Concurrent Editing sessions, while on the customization side, CSS variables are now supported and the feature that displays a DITA map with all of the referenced topic content expanded/editable in one document can now be enabled for Bitbucket integrations.

This release also includes new API methods, various bug fixes, and component updates.

=============================================================================

Version 4.0 of Oxygen Content Fusion, the innovative collaboration tool that is designed to improve any documentation review process, brings you the ability for collaborative teams to edit and review content concurrently. This means that you and your colleagues can edit and review the same document simultaneously in the visual editor and each user can see the changes in real time.

Some of the other interesting new features and improvements added in this version include a new dynamic floating toolbar that gives you easier access to the most common editing and styling actions, the option to change the UI language to English, French, German, Dutch, Japanese, or Chinese, and the preservation of styling when you copy content in the visual editor and paste it into an external application.

We hope you will enjoy our latest release of the Oxygen XML suite of products!
As always, any feedback on it is welcomed.

Best regards!

--
Alin Belu
Oxygen XML Editor

Re: ** SPAM scored: Med ** [dita-users] WebHelp on a shoestring?

Nancy Roberts

Thank you. I don't have any current plans to expand my freelancing to additional clients, though. This particular one is a friend. Otherwise, I'm a W2 all the way.

Nancy

Re: WebHelp on a shoestring? #dita-ot

Nancy Roberts

Gentlemen, thanks very much. I'll be back with more questions as they come up.

Regards,
Nancy

Re: WebHelp on a shoestring? #dita-ot

Rodolfo M. Raya

Conversa also generates HTML5 and is free.

Regards,
Rodolfo

On Mon, Mar 1, 2021 at 1:33 PM Nancy Roberts <nanr93@...> wrote:
Hi Mark,

HTML5 is the backup plan. I was hoping to find another way, that's all.

Thanks!
Nancy

Re: WebHelp on a shoestring? #dita-ot

Rodolfo M. Raya

That's correct, Nancy.

Conversa does not need DITA-OT. It includes ditac and generates web help right out of the box.

Regards,
Rodolfo

On Mon, Mar 1, 2021 at 1:35 PM Nancy Roberts <nanr93@...> wrote:
Hi Rodolfo,

Just so I understand - if I use Conversa, there's no need for an installation of the DITAOT?

Thanks,
Nancy

Re: WebHelp on a shoestring? #dita-ot

David Hollis

Hi Nancy,

WordPress is not really webhelp, but there are tools to convert DITA-OT output to WordPress.

BTW, one approach to site search is to use Google, with site=<URL> added to the query.

HTH,
David

Hi David,

I don't know the first thing about WordPress. I'll look into it.

Thanks!
Nancy

Re: WebHelp on a shoestring? #dita-ot

Nancy Roberts

Hi Rodolfo,

Just so I understand - if I use Conversa, there's no need for an installation of the DITAOT?

Thanks,
Nancy

Re: WebHelp on a shoestring? #dita-ot

Nancy Roberts

Hi David,

I don't know the first thing about WordPress. I'll look into it.

Thanks!
Nancy

Re: WebHelp on a shoestring? #dita-ot

Nancy Roberts

Hi Mark,

HTML5 is the backup plan. I was hoping to find another way, that's all.

Thanks!
Nancy

Re: hide and seek

Aaron Mehl

This I did, but I was referring to the actual document flow. I added topics to explain a topic. I now see that what I wanted was to streamline the published document so the end user wouldn't get bogged down or confused.
Aaron

On Saturday, February 27, 2021, 07:07:08 PM EST, selvats via groups.io <selvats@...> wrote:

Please use the toc=no attribute on the topicref for the topic to hide it from the TOC.

Re: WebHelp on a shoestring? #dita-ot

Rodolfo M. Raya

Hello Nancy,

You can generate nice web help and other formats with Conversa, https://www.maxprograms.com/products/conversa.html

Conversa is free and open source. It uses XMLMind's DITA Converter (ditac) to generate output from your DITA sources.

You can configure the appearance of the generated web help, although the default already looks good.

Give it a try, the price is not an obstacle :)

Regards,
Rodolfo

On Sun, Feb 28, 2021 at 3:52 PM Nancy Roberts <nanr93@...> wrote:
Hi again,

I'm looking into providing webhelp for a single client I freelance for. What's the cheapest way to get webhelp output? Oxygen Editor offers a $200 personal license, which is still a lot for a single client. I've found a freeware editor (Codex), and of course the OT itself is free. Is there a free webhelp plugin anywhere to the OT? I can't find one that looks viable. Thanks! Nancy Re: WebHelp on a shoestring? #dita-ot David Hollis Hi Nancy, What about DITA to WordPress? HTH, David Hi again, I'm looking into providing webhelp for a single client I freelance for. What's the cheapest way to get webhelp output? Oxygen Editor offers a$200 personal license, which is still a lot for a single client. I've found a freeware editor (Codex), and of course the OT itself is free. Is there a free webhelp plugin anywhere to the OT? I can't find one that looks viable.

Thanks!
Nancy

Re: ** SPAM scored: Med ** [dita-users] WebHelp on a shoestring?

Niels Grundtvig Nielsen

XML Mind (DITA only edition) appears to offer a single-user licence for $175, and then you’d be kitted out to propose elegant WebHelp to more of your clients. Of course, in an ideal world the client would accept that their requirement needs the intersection of the skills you have and the software you don’t … but it’s been a lo-o-ong time since I had to do that sort of arm-wrestling. Good luck! Niels Grundtvig Nielsen technical author Worldline Terminals, Solutions and Services Worldline Expert in technical communications you know what you’re talking about – I can help you say it 3/5 – out of office Thursday and Friday From: main@dita-users.groups.io [mailto:main@dita-users.groups.io] On Behalf Of Nancy Roberts Sent: zondag 28 februari 2021 19:52 To: main@dita-users.groups.io Subject: ** SPAM scored: Med ** [dita-users] WebHelp on a shoestring? #dita-ot Caution! External email. Do not open attachments or click links, unless this email comes from a known sender and you know the content is safe. Hi again, I'm looking into providing webhelp for a single client I freelance for. What's the cheapest way to get webhelp output? Oxygen Editor offers a$200 personal license, which is still a lot for a single client. I've found a freeware editor (Codex), and of course the OT itself is free. Is there a free webhelp plugin anywhere to the OT? I can't find one that looks viable.

Thanks!
Nancy

Worldline and Ingenico are registered trademarks and trade names owned by the Worldline Group. This e-mail and any documents attached are confidential and intended solely for the addressee. If you are not the intended recipient of this e-mail, you are not authorized to copy, disclose, use or retain it. Please notify the sender immediately and delete this e-mail (including any attachments) from your systems. As e-mails may be intercepted, amended or lost, they are not secure. Worldline and its subsidiaries therefore cannot accept liability for any errors in their content. Although the Worldline Group endeavours to maintain a virus-free network, we do not warrant that this e-mail is virus-free and do not accept liability for any damages or losses resulting from any transmitted virus if any. The risks are deemed to be accepted by anyone who communicates with Worldline or its subsidiaries by e-mail.

Re: WebHelp on a shoestring? #dita-ot

Mark Giffin

Do you need webhelp features like full-text search? That's the hardest thing to do yourself. What about giving them plain HTML5 output

On 2/28/2021 10:52 AM, Nancy Roberts wrote:
Hi again,

I'm looking into providing webhelp for a single client I freelance for. What's the cheapest way to get webhelp output? Oxygen Editor offers a $200 personal license, which is still a lot for a single client. I've found a freeware editor (Codex), and of course the OT itself is free. Is there a free webhelp plugin anywhere to the OT? I can't find one that looks viable. Thanks! Nancy WebHelp on a shoestring? #dita-ot Nancy Roberts Hi again, I'm looking into providing webhelp for a single client I freelance for. What's the cheapest way to get webhelp output? Oxygen Editor offers a$200 personal license, which is still a lot for a single client. I've found a freeware editor (Codex), and of course the OT itself is free. Is there a free webhelp plugin anywhere to the OT? I can't find one that looks viable.

Thanks!
Nancy

Re: New installation of the DITA-OT

Nancy Roberts

That worked - thank you! And thank you too, Alan!

Have a great evening.

Nancy

Re: New installation of the DITA-OT

Alan Houser

Hi again,

How about ... in your Windows shell, change you current directory to the location of sequence.ditamap? (I usually work in a UNIX shell ... "cd" command. It may be "dir" in Windows). If you're using "--input=sequence.ditamap", the 'dita' command will look for the ditamap in the current directory. (Since your "PATH environment variable is set, your system should find the 'dita' command regardless of current directory).

Or try using the full path to the ditamap as an argument to --input: "--input=C:\Program Files\dita-ot-3.6\docsrc\samples\sequence.ditamp". Another possibility ... you may need to double each backslash character: "\\".

HTH!

-Alan

On 2/27/21 10:11 PM, Nancy Roberts wrote:
Whoops, I pasted the wrong example. Like I said, I'm good with GUI-based tools. I've never done anything serious with the command line. This is sort of a trial by fire.

So now my problem is the input path. I've tried every combination of .\ and ..\ that I can think of. I can't find the right combination to run the sample map provided in the OT. The map's path is C:\Program Files\dita-ot-3.6\docsrc\samples\sequence.ditamp. I set the PATH environment variable to C:\Program Files\dita-ot-3.6\bin.

How do I run this command? Running the suggested syntax gets me nowhere:
--input=sequence.ditamap --format=html5
Error: Failed to run pipeline: [DOTA069F][FATAL] Input file 'file:/C:/Program%20Files/dita-ot-3.6/sequence.ditamap' cannot be located or read. Ensure that file was specified properly and that you have permission to access it.

Adding some combination of .\ and ..\ makes it worse.
Help...

Thanks!
Nancy
--
Alan Houser
Group Wellesley, Inc.
Consultant and Trainer, Technical Publishing
412-450-0532