Date   

Re: Include plain text from external file?

Kim Wickens
 

Thank you! Finding this thread solves some txt content migration that took over 8 hours and needs to be done once or twice a year. This solution is going to cut the time down to minutes.


Re: Word2DITA plug-in: cross-references

ekimber@contrext.com
 

Please file an issue on the word2dita github project and provide a DOCX file that demonstrates the issue and I'll take a look at it.

https://github.com/dita4publishers/org.dita4publishers.word2dita/issues

I’m not sure I understand the difference between hyperlinks and cross references in this context, so I you can describe how the cross references are created that will help too.

Cheers,

E.

--
Eliot Kimber
http://contrext.com


On 10/13/20, 10:54 AM, "Pieterjan Vandenweghe" <main@dita-users.groups.io on behalf of pieterjan.vandenweghe@gmail.com> wrote:

I am using the Word2DITA plug-in for the conversion of Word files to DITA.
This works fine for me in most cases, but I have a problem when cross-references are inserted in the DOCX files.


The links to all cross-references are lost in my final DITA files.
Is there any support for cross-references in the plug-in? (If I am correct, hyperlinks added with the Insert > Link feature in Word is supported).
Is there anyone who can help me to solve this or give me an idea how get this done?

Thanks a lot in advance for your reply.
Pieterjan


Word2DITA plug-in: cross-references

Pieterjan Vandenweghe
 

I am using the Word2DITA plug-in for the conversion of Word files to DITA. 
This works fine for me in most cases, but I have a problem when cross-references are inserted in the DOCX files.


The links to all cross-references are lost in my final DITA files.
Is there any support for cross-references in the plug-in? (If I am correct, hyperlinks added with the Insert > Link feature in Word is supported).
Is there anyone who can help me to solve this or give me an idea how get this done? 

Thanks a lot in advance for your reply.
Pieterjan


Re: a reltable question, I think … #reltable

Niels Grundtvig Nielsen
 

Thanks, Chris and Yves – we have a couple of hundred topics in this help set so far, and this is the first time we’ve needed to tackle this particular challenge.

 

Pending a more thorough investigation of the possibilities you mention, I’ve opted for a hand-rolled <related links> section in the top-level topic, but used a reltable for the links between the low-level topics.

 

N

 

From: main@dita-users.groups.io [mailto:main@dita-users.groups.io] On Behalf Of Chris Papademetrious
Sent: woensdag 7 oktober 2020 16:40
To: main@dita-users.groups.io
Subject: Re: [dita-users] a reltable question, I think … #reltable

 

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 Niels,

For the first, we developed a <mini-toc> element that allows us to put inline unordered lists of child topics wherever we want, optionally with introductory content. See:



For example,

<mini-toc><p>This is described in the following topics:</p></mini-toc>



becomes

This is described in the following topics:

  • Subtopic 1
  • Subtopic 2
  • Subtopic 3


Plus in Oxygen's PDF Chemistry, we apply the CSS keep-with-previous pagination property to keep the topic list with its introduction.

It's not exactly what you want (i.e. not in a related links section) but it's tangentially related so I figured I'd throw it out there.

 - Chris


*********************************************************************************************
Worldline is a registered trade mark and trading name owned by Worldline through its holding company.

This e-mail and the documents attached are confidential and intended solely for the addressee. If you receive this e-mail in error, you are not authorized to copy, disclose, use or retain it. Please notify the sender immediately and delete this email from your systems. As emails may be intercepted, amended or lost, they are not secure. Worldline therefore can accept no liability for any errors or their content. Although Worldline endeavours to maintain a virus-free network, we do not warrant that this transmission is virus-free and can accept no liability for any damages resulting from any virus transmitted. The risks are deemed to be accepted by everyone who communicates with Worldline by email.


[ann] Oxygen Feedback version 1.3 is available! #Oxygen

alin_belu@...
 

Hello,
 
We are happy to announce the release of Version 1.3 of Oxygen Feedback!
This version introduces the Enterprise self-managed edition of the Oxygen Feedback commenting system, which allows you to install the platform software on your own servers.
 
=================================================================
 
Some of the most important features found in Oxygen Feedback version 1.3 include:
 
* The new Enterprise edition Platform Admin account provides access to a special administration area to view and manage all of the site configurations for your organization.
 
* The Enterprise edition offers the ability to enable and configure LDAP authentication for your organization.
 
* The Enterprise edition is compatible with the old Oxygen WebHelp PHP-based commenting system, which means that you can migrate your database without losing any information.
 
* A helpful Dashboard page aggregates information about all of your existing site configurations and provides easier access to relevant parts of the interface.
 
* The Dashboard includes a site pane that you can use to visualize information about your site configurations, navigate to them for management purposes, and create new ones.
 
* The Dashboard has an activity stream pane that shows information about the most recent activities performed by members of your team or community.
 
* The Dashboard also contains some statistics panes (such as statistics for Page Views and Comments) that make it easy to analyze your community's usage data.
 
=================================================================
 
The Oxygen Feedback commenting platform provides a simple and efficient way for your community to interact and offer feedback. Its modern, stylish appearance looks great on any website, it is very easy to configure and integrate, and it includes a user-friendly interface and numerous useful features for both Commenters and Administrators.
It is specialized for technical documentation and can be easily integrated with Oxygen XML Editor/Author to make it more efficient for content authors to manage comments and react to community feedback.
Oxygen Feedback can also be easily integrated with a Webhelp responsive output, transforming into an indispensable collaboration tool between your site's community, the authors, and the reviewers. 

We also want to let you know about the Oxygen Feedback Enterprise Special Offer for Existing Customers:
 
If you already own an Oxygen XML Editor, Oxygen XML Author, Oxygen XML Developer, Oxygen WebHelp, or Oxygen Publishing Engine license key, you are eligible to get a 50% discount off the Oxygen Feedback Enterprise edition for the first year of subscription. This promotion applies to every Oxygen Feedback Enterprise edition subscription plan and requests must be received by 31 December 2020.
 
To see if you are eligible to obtain this discount, visit:
http://www.oxygenxml.com/oxygen_feedback_enterprise/special_offer.html
 
Best regards,
Alin

--
Alin Belu
Oxygen XML Editor


Re: a reltable question, I think … #reltable

Chris Papademetrious
 

Hi Niels,

For the first, we developed a <mini-toc> element that allows us to put inline unordered lists of child topics wherever we want, optionally with introductory content. See:



For example,

<mini-toc><p>This is described in the following topics:</p></mini-toc>


becomes

This is described in the following topics:

  • Subtopic 1
  • Subtopic 2
  • Subtopic 3

Plus in Oxygen's PDF Chemistry, we apply the CSS keep-with-previous pagination property to keep the topic list with its introduction.

It's not exactly what you want (i.e. not in a related links section) but it's tangentially related so I figured I'd throw it out there.

 - Chris


Re: a reltable question, I think … #reltable

Yves Barbion
 

Hi Niels

If you use Oxygen and you publish to responsive webhelp, you can set this in your parameters of the DITA-OT:

webhelp.show.child.links: yes

I guess/hope other tools and publication formats have something similar. MiramoPDF, for example, has "includeChapterTOC:yes".

Cheers

Yves



On Wed, 7 Oct 2020 at 15:44, Niels Grundtvig Nielsen <niels.grundtvignielsen@...> wrote:
I need a first, top-level topic to have a list (probably 'related information') that shows references to nine subtopics.
Each of the nine subtopics then needs a 'related information' list showing the other eight – but does not need to mention the top-level topic.
I've managed the second requirement with a single-column reltable, but I can't work out how to meet the first requirement.
Approximate example below; hints and tips welcome!

- - - - - - - - -
topic 1 title "too much information"
The information is presented on nine tabs.

1.1 baby salvia
1.2 colouring book
1.3 unicorn tacos
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu
- - - - - - - - -
 
topic 1.1 title "baby salvia"
Helvetica glossier skateboard palo santo cred activated charcoal post-ironic butcher pug roof party hella venmo. Lyft synth thundercats chillwave, sartorial fashion axe brooklyn pop-up fixie quinoa post-ironic brunch.
 
related information
1.2 colouring book
1.3 unicorn tacos
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu
- - - - - - - - -
 
topic 1.2 title "colouring book"
Offal beard. Lyft cliche air plant echo park 90's vexillologist. Forage pinterest blue bottle celiac. Sriracha tumblr quinoa, aesthetic four loko kale chips next level vegan hell of. Cold-pressed raw denim bitters cornhole austin migas.
 
related information
1.1 baby salvia
1.3 unicorn tacos
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu
- - - - - - - - -
 
topic 1.3 title "unicorn tacos"
Bitters godard iceland mumblecore woke pop-up authentic quinoa retro chambray. Paleo bespoke locavore snackwave unicorn jianbing knausgaard four dollar toast swag pinterest activated charcoal sustainable viral ennui.
 
related information
1.1 baby salvia
1.2 colouring book
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu


a reltable question, I think … #reltable

Niels Grundtvig Nielsen
 

I need a first, top-level topic to have a list (probably 'related information') that shows references to nine subtopics.
Each of the nine subtopics then needs a 'related information' list showing the other eight – but does not need to mention the top-level topic.
I've managed the second requirement with a single-column reltable, but I can't work out how to meet the first requirement.
Approximate example below; hints and tips welcome!

- - - - - - - - -
topic 1 title "too much information"
The information is presented on nine tabs.

1.1 baby salvia
1.2 colouring book
1.3 unicorn tacos
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu
- - - - - - - - -
 
topic 1.1 title "baby salvia"
Helvetica glossier skateboard palo santo cred activated charcoal post-ironic butcher pug roof party hella venmo. Lyft synth thundercats chillwave, sartorial fashion axe brooklyn pop-up fixie quinoa post-ironic brunch.
 
related information
1.2 colouring book
1.3 unicorn tacos
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu
- - - - - - - - -
 
topic 1.2 title "colouring book"
Offal beard. Lyft cliche air plant echo park 90's vexillologist. Forage pinterest blue bottle celiac. Sriracha tumblr quinoa, aesthetic four loko kale chips next level vegan hell of. Cold-pressed raw denim bitters cornhole austin migas.
 
related information
1.1 baby salvia
1.3 unicorn tacos
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu
- - - - - - - - -
 
topic 1.3 title "unicorn tacos"
Bitters godard iceland mumblecore woke pop-up authentic quinoa retro chambray. Paleo bespoke locavore snackwave unicorn jianbing knausgaard four dollar toast swag pinterest activated charcoal sustainable viral ennui.
 
related information
1.1 baby salvia
1.2 colouring book
1.4 forage lo-fi
1.5 brunch 
1.6 tacos biodiesel
1.7 street art
1.8 hexagon master
1.9 Polaroid tofu


tutorialinfo

Yves Barbion
 

Hi group

I'm looking for some good examples of pieces of content in the <tutorialinfo> element. Anyone?

Thanks

Yves


[ANN][Conference] DCL organises a half-day conference UK/Europe #conferences

nkerzreho
 

Hi all,

Announcing a new 1/2 day conference with practical discussions on migrating to DITA, from planning, to budget and content migration.

Join us by registering here:
https://register.gotowebinar.com/register/158390555951721484

Looking forward to meeting you there!

Excerpt:

DCL DITA Day is a half-day seminar to help organizations based in the EU and UK transition to DITA (Darwin Information Typing Architecture). This online event features key executives who have successfully traversed a DITA migration and are now reaping the benefits.

The goal of this event is to help organizations identify the barriers to a DITA migration and collectively outline ways to overcome those barriers, creating a clear process to move to a DITA-based content reuse workflow.

We’ll have panel-style conversations that discuss

  1. planning

  2. resourcing

  3. budgeting

  4. tools selection

  5. data conversion

  6. training


[ann][webinar] Working with DITA in Oxygen - Basic Profiling and Reuse Strategies #Oxygen

alin_belu@...
 

Hello, 
 
Do you want to make your DITA authoring experience even better? 
If the answer is a resounding YES, next Wednesday (October 7), we invite you to the second event of our weekly series of live webinars - “Working with DITA in Oxygen - Basic Profiling and Reuse Strategies”. 
Sorin Carbunaru, lead developer at Syncro Soft / Oxygen XML Editor, will cover some of the most important concepts of DITA: profiling and content references. With his guidance, you will learn the benefits of knowing how to reuse and profile content in your documents, and how easy it is to do this in Oxygen. 
 
At the end of this webinar, you will master the following: 
* How to filter content in the published output using profiling attributes. This allows you to obtain various outputs from the same documentation source. 
* How to combine more profiling attributes in condition sets. 
* How to apply DITAVAL filters in Oxygen. 
* Various strategies and best practices for reusing DITA content in Oxygen. 
 
This is a free event and you can register at http://www.oxygenxml.com/evs2020-11.html 
 
Check the full list of the upcoming webinars and follow the links to see more details and register for free: 

 
Best regards, 
Alin

--
Alin Belu
Oxygen XML Editor


[ann][webinar] Templates for #API Docs with Clarence Cromwell #tcdojo free 5 Oct @ 9AM PT

Liz Fraley
 

Title: Templates for #API Docs

When: Monday, 5 Oct, 9:00 AM - 9:30 AM PT

Register: http://bit.ly/tcdojo-202010-cromwell

Description:

Templates can improve your documentation no matter what your skill level is, and no matter how mature the documentation set.

Clarence Cromwell will talk about a set of templates for minimum viable API documentation, including:
* What is "minimum viable documentation"
* Why these three templates
* Why each template contains what it does
* How templates can be used to form new doc sets or improve old ones

About the Visiting TC Dojo Master:

Clarence Cromwell is a senior technical writer for Synopsys.


-:-

The TC Dojo is brought to you by Single-Sourcing Solutions. At the TC Dojo, you pick the topics and we find the experts. Learn more: http://webinar.tcdojo.org


Register: http://bit.ly/tcdojo-202010-cromwell


Job opportunity

Dan Vint
 

Ping Identity is looking for a content tools dev ops person. You will be one of two people supporting:
- DITA publishing process using Ixiasoft CCMS with oXygen and Zoomin delivery.
- We have an API pipeline as well that is hosted on a different site and uses Postman to manage the content
- We use Coveo search engine as the enterprise search engine that ties all of our content together
- We are part of the Customer Care organization which also includes support and training. As such we work with Salesforce engineers the KBs

The specific position that is open will focus on the Coveo search function. There is a general admin console used to manage the pipelines as well as analytics. This role will be responsible to monitoring the analytics and tweaking the search process (synonyms, machine learning, promoting content).

This position will also backstop me with handing issues with the Ixiasoft/Zoomin process as well as the API content.

You will be:
- the Coveo Guru and involved at the enterprise level as different groups adopt and modify their use of Coveo
- Troubleshoot and research problems. Primary responsibility will be around Coveo issues, but you will need to get into the DITA content to help with publishing and content problems.
- You will be the helpdesk for Coveo but also support the writers with the other applications as needed.

We support a team of technical writers and editors that are located in Canada, USA, Israel and India.

The applicant must be able to get into one of these offices once things open up again. Currently the company is not expecting that to happen until summer '21. Offices are:
- Denver CO (headquarters, most of the writers are here as well as the manager)
- Austin TX (couple of writers here)
- Vancouver Canada (couple of writers here)
- Boston MA (no writers)

If you have any questions contact me at danvint@pingidentity.com

You can apply here https://www.pingidentity.com/en/company/careers/listings.html and you can use my name as the contact/reference (Dan Vint).


Re: Convert SVG-to-PNG in the publishing stage?

glenn emerson
 

One thing to watch with SVGs, if you notice the publication process slowing down, is font substitution on PDF transforms. When you create a PDF, to maintain the exact presentation and layout, the PDF wants to have the fonts used embedded within. 

To embed a font in a PDF is essentially copying software. The font must be licensed. Each font installed on a computer has a licensing bit indicating whether it is licensed for embedding or not. 

When the PDF generator tries to convert the XSL-FO (or whatever intermediate format you are using) to PDF, it checks the fonts. If the font is not licensed for embedding, it substitutes the font for one that is licensed on that computer. With SVGs this can cause significant delays, especially if individual characters (such as callouts) are inserted.

By default in Windows, the only fonts licensed for embedding are Arial, Times New Roman, Courier, and I think Calibri. If you wish to use other fonts, you must license them (Microsoft and other “type foundries” have online portals where you can license their fonts).

To further Some SVG editors, such as Adobe Illustrator, like to include font names in the SVG. Illustrator used to default to Adobe Type I Postscript names, instead of TrueType names (now OpenType) for instance, in Windows. So, what you get when you insert Arial in an SVG on Illustrator was a call for the Arial Postscript font, instead of a reference to arial.ttf (the TrueType version on Windows). 

Solution:
Either license the font(s) that are included in the SVGs, OR configure the SVG creation tools to default to certain fonts that are licensed, such as arial.ttf. (You can check in your PDF/Ant House/RenderX server’s font folder to see which are licensed. 

I have seen this with RenderX XEP cut publishing time from hours to minutes on the same document. 


On Sep 30, 2020, at 9:06 AM, Yves Barbion <yves.barbion@...> wrote:

Hi group

SVGs from engineering drawings can be quite heavy in terms of file size and they tend to slow down the publication process dramatically. Therefore, I was wondering whether there are some good conversion tools around which can convert the SVGs to PNG when the DITA content is published to HTML and PDF, using the DITA-OT?

We want to keep using SVG in the DITA source files for the obvious reasons: editable vectors, editable and translatable text...

Kind regards

Yves

______________________________
Glenn Emerson
585-732-6984






Convert SVG-to-PNG in the publishing stage?

Yves Barbion
 

Hi group

SVGs from engineering drawings can be quite heavy in terms of file size and they tend to slow down the publication process dramatically. Therefore, I was wondering whether there are some good conversion tools around which can convert the SVGs to PNG when the DITA content is published to HTML and PDF, using the DITA-OT?

We want to keep using SVG in the DITA source files for the obvious reasons: editable vectors, editable and translatable text...

Kind regards

Yves


Re: Unable to locate AXF, set property axf.path or axf.cmd

Toshihiko Makita
 

Hi Nick,
If you are using PDF2 transform, don't you forget setting pdf.formatter property?

dita-ot-3.5/plugins/org.dita.pdf2/build.xml

    <!-- configure FO engines -->
    <!-- default is FOP.  Can be changed here, or with pdf.formatter property. -->
    <property name="pdf.formatter" value="fop"/>

This property should be set as pdf.formatter="ah", if you want to invoke AH Formatter in PDF2.

Regards,

-- 
/*------------------------------------------------------------------------ 
 Toshihiko Makita
 Development Group. Antenna House, Inc. Ina Branch
 Web site:
 http://www.antenna.co.jp/
 http://www.antennahouse.com/
 ------------------------------------------------------------------------*/ 


Re: Unable to locate AXF, set property axf.path or axf.cmd

Bill Burns
 

I've always found it helpful to add AntennaHouse to my environmental variables. Same with the OT, whatever JDK or JVM I need, and any other utilities like Ant that I'm using regularly.

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



On Mon, Sep 28, 2020 at 9:22 AM Westley W. <wamsley@...> wrote:

This issue with Antenna House has plagued us as well.  Setting the local.properties seemed to resolve the issue for myself but has been hit or miss with our other users. 

Looking at what you have, I would try using double backward slashes as that is how ours are set. Like so.

axf.path=\\AH\\AHFormatterV66_64
axf.cmd=\\AH\\AHFormatterV66_64\\bin\\AHFCmd




Re: Unable to locate AXF, set property axf.path or axf.cmd

Westley W.
 

This issue with Antenna House has plagued us as well.  Setting the local.properties seemed to resolve the issue for myself but has been hit or miss with our other users. 

Looking at what you have, I would try using double backward slashes as that is how ours are set. Like so.

axf.path=\\AH\\AHFormatterV66_64
axf.cmd=\\AH\\AHFormatterV66_64\\bin\\AHFCmd


CHM Index customization

dawn.stevens@...
 

We need to customize the HHK file of a CHM output so that the file names are determined by the contents of <resourceid> rather than just using the file name. If no <resourceid> exists, the html file saves according to the name of the DITA file, but if a <resourceid> exists it specifies the required name of the file. This was necessary due to a migration of content from another system; the software is looking for a specific file name that was generated out of the old system, but we don't want to keep the non-human readable file names in the new system. So existing topics use the <resourceid> to specify the old file name to use when outputting to the CHM used for context sensitive help. We successfully have all links and the ToC working correctly, but are unable to figure out how to write the correct file names to the HHK file for the index.


Unable to locate AXF, set property axf.path or axf.cmd

Nicholas Mucks
 

Hello!
We have a docker image with OT3.5. The PDF output works fine in FOP but if we use AH in the image, then we get a "Unable to locate AXF, set property axf.path or axf.cmd" error. AH is installed on the image but I'm not sure how to set up the rest.

Do we add a local.properties file to the root of the OT? If so, a local.properties file like this doesn't seem to work:
axf.path=/AH/AHFormatterV66_64
axf.cmd=/AH/AHFormatterV66_64/bin/AHFCmd

I tried to set these values in the PDF plugin as well, but that didn't work either.

   <property name="axf.cmd" location="/AH/AHFormatterV*/run.sh"/>

    <property name="axf.path" location="/AH/AHFormatterV*/"/>

    

Any ideas?

Thanks!
Nick

501 - 520 of 46295