Date   

Re: Cross-reference to another topic

jdaniel@...
 

I have ran into an issue when cross-referencing another topic for html output. #2 works for me in some cases. When it doesn't work, a page appears telling me the file is not found.  #1 opens the xml (code) file, but not the formatted output. 

Any ideas as to what my problem might be?

Thanks,
Julie


Re: Companies using keys and AEM + XML plug-in #keys #CCMS

Julio J Vazquez
 

Hi Kris, 

We use AEM with oXygen, though sometimes I use the editor. We aren't using keys yet but have a requirement with our IT team to support keys. 

Julio J. Vazquez


Re: Companies using keys and AEM + XML plug-in #keys #CCMS

Huntley Eshenroder
 

Hi Kris,

We are using AEM and keys, though in a fairly vanilla manner. We aren't live yet in AEM but looking to get there this year. We too are using the built in web editor. Feel to reach out if you want more info.

-Huntley


On Sat, Nov 21, 2020 at 8:30 AM Kristen James Eberlein <kris@...> wrote:

I would like to get in touch with people at companies who use Adobe AEM + XML as their CCMS -- and their DITA information model uses keys.

  • Are you using the built-in AEM Web editor?
  • Are you using an external authoring tool, such as Adobe FrameMaker or Oxygen XML Editor?
--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



Re: Companies using keys and AEM + XML plug-in #keys #CCMS

John Piechowski
 

We are using Adobe AEM and keys. We use the built in web editor. Happy to connect and provide more details.

John


On Sat, Nov 21, 2020, 8:30 AM Kristen James Eberlein <kris@...> wrote:

I would like to get in touch with people at companies who use Adobe AEM + XML as their CCMS -- and their DITA information model uses keys.

  • Are you using the built-in AEM Web editor?
  • Are you using an external authoring tool, such as Adobe FrameMaker or Oxygen XML Editor?
--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



Companies using keys and AEM + XML plug-in #keys #CCMS

Kristen James Eberlein
 

I would like to get in touch with people at companies who use Adobe AEM + XML as their CCMS -- and their DITA information model uses keys.

  • Are you using the built-in AEM Web editor?
  • Are you using an external authoring tool, such as Adobe FrameMaker or Oxygen XML Editor?
--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)



Re: #DITA-OT #XSLT #PDF #DITA-OT #XSLT #PDF

nyxys21@...
 

Just in case anyone has the same question, I found a simple solution. In root-processing.xsl I replaced the bookmap template with the map template. Now the pages flow like it's a map, without page breaks, and we can still use the bookmap metadata.

I copied this template into my copy of root-processing:
<xsl:template match="*[contains(@class, ' map/map ')]" mode="generatePageSequences">
...

and renamed it to:
<xsl:template match="*[contains(@class, ' bookmap/bookmap ')]" mode="generatePageSequences">
...


#DITA-OT #XSLT #PDF #DITA-OT #XSLT #PDF

nyxys21@...
 

Hi All,

I need to prevent page breaks before top level topics in a bookmap. I know it would work like that if we switched to a map, but we need the bookmeta.

The custom plugin is based off the PDF2 plugin and the DITA-OT is version 3.3. I saw some solutions but they are pretty old and don't seem to work in 3.3. They give an error "fo:page-sequence" is not a valid child of "fo:flow".

I think it must be somewhere is custom.xsl and root-processing.xsl but so far nothing has worked. I've accidentally gotten every topic onto a new page... but mostly my attempts result in that error message I mentioned.

Really appreciate any help. Thanks!


[Ann] Oxygen XML Editor version 23.0 release

Radu Coravu
 

Hi everyone,

We are happy to announce that Oxygen XML Author/Editor version 23 is available!

For the complete list of features, go to https://www.oxygenxml.com/xml_editor/whats_new.html

Listing below some new features which may be useful for our DITA users:

DITA Authoring

* Floating Toolbar Provides Quicker Access to Common DITA Editing Actions

* Edit Submaps Directly in the DITA Maps Manager View

* Edit Referenced Content When Opening a DITA Map With Expanded Topics

* Support for Creating DITA 2.0 Maps and Topics

* New DITA-Related Project Templates

* Context Drop-Down in DITA Maps Manager Improved

* New Author Actions Added in Contextual Menu

* Resource-Only Topic References Easier to Spot

* Topic Validation Reports Missing IDs in References

For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html#23.0DITA_Authoring


DITA Publishing

* Run Multiple Transformations on a Single DITA Map in Parallel

* DITA-OT Memory Usage Optimized

For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html#23.0DITA_Publishing


Add-ons

* Terminology Checker

* Git Client Improvements

* Convert Sections in a Word Document to DITA Topics

* Translator Helper

* Vale Validation for Markdown and HTML Files

For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html#23.0Add-ons


Scripting

* Validate DITA-OT Project Files

* New Command Line Launcher for the DITA Translation Package Builder

* New Command Line Launcher for the Batch Converter

* New Command Line Launcher for Transformation Scenarios

For more information, see: https://www.oxygenxml.com/xml_editor/whats_new.html#23.0Scripting


We hope you will enjoy Oxygen 23!
As always, any feedback on it is welcomed.

Best regards,

Radu Coravu

Radu Coravu
Oxygen XML Editor


Re: #Oxygen #Oxygen

Radu Coravu
 

Hello Ritu,

Yes, this can be customized. There is a content completion configuration file located in:

OXYGEN_INSTALL_DIR/frameworks/dita/resources/cc_config.xml

and it defines those values:

<match attributeName="type">
<items action="addIfEmpty">
<item value="topic"/>
<item value="task"/>
<item value="concept"/>
<item value="reference"/>
</items>
</match>
You can talk to Chris to maybe add another value for the @type attribute in the DITA framework customization he has probably already created for your company.


Regards,
Radu

Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

On 11/18/2020 12:12 PM, ritus@synopsys.com wrote:
Hi Radu,
Thank you! for your response.
In Oxygen, I see only concept, reference, task, and topic as options for xref >type attribute by default.
Can this be customized?
Thanks,
Ritu


Re: #Oxygen #Oxygen

ritus@...
 

Hi Radu,

 

Thank you! for your response.

In Oxygen, I see only concept, reference, task, and topic as options for xref >type attribute by default.

Can this be customized?

 

Thanks,
Ritu


Re: [Ann] Oxygen Terminology Checker add-on version 2.0.

Adam Myers
 

Ugh - Thank you! Everything is working now!

Adam


Re: #Oxygen #Oxygen

Radu Coravu
 

Hi Ritu,

You seem to have attached an image but I'm having trouble opening it, can you change its format from emf to some more common format like PNG?

You can use the Oxygen Attributes view to set the @type attribute on an xref element.

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 11/16/20 1:50 PM, ritus@... wrote:

Hi All,
I wanted to understand, does Oxygen support use-by-reference Footnote?  
I don’t see the support for type =”fn” for xref element in Oxygen  22.1  
 
Thanks, Ritu

  


Re: [Ann] Oxygen Terminology Checker add-on version 2.0.

Radu Coravu
 

Hi Adam,

I'm happy you are enjoying the add-on.

It looks like as if you downloaded from Github the HTML equivalents of the Yaml files, not the Yaml files themselves.

Can you open each Yaml file and make sure it's contents is Yaml and not HTML?

For example if I open a Yaml file in Github:

https://github.com/errata-ai/Microsoft/blob/master/Microsoft/Accessibility.yml

there is a "Raw" button there. You should press that button to get the actual contents of the file.

Maybe you can download the entire Vale Microsoft style guide GitHub project as a zip:

https://github.com/errata-ai/Microsoft/archive/master.zip

and obtain the Yaml files from that zip instead of manually downloading them.

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 11/12/20 6:51 PM, Adam Myers wrote:

Hi Radu,

I love this. I have been testing it out this morning and can't wait to share it with my team. I downloaded some of the Microsoft .yml files and the are correctly identifying issues that I created in my test topic. The one issue I am having is I am getting validation errors on the .yml files.

mapping values are not allowed here
 in 'reader', line 147, column 34:
        <span style="background-color: #79b8ff;width: 0%;" class="Pro ... 
                                     ^
The terminology issues are underlined in the editor. What should I do about these validation errors?
 
Thanks,
 
Adam

  


Re: [Ann] Oxygen Terminology Checker add-on version 2.0.

Adam Myers
 

Hi Radu,

I love this. I have been testing it out this morning and can't wait to share it with my team. I downloaded some of the Microsoft .yml files and the are correctly identifying issues that I created in my test topic. The one issue I am having is I am getting validation errors on the .yml files.

mapping values are not allowed here
 in 'reader', line 147, column 34:
        <span style="background-color: #79b8ff;width: 0%;" class="Pro ... 
                                     ^
The terminology issues are underlined in the editor. What should I do about these validation errors?
 
Thanks,
 
Adam


#Oxygen #Oxygen

ritus@...
 

Hi All,
I wanted to understand, does Oxygen support use-by-reference Footnote?  
I don’t see the support for type =”fn” for xref element in Oxygen  22.1  
 
Thanks, Ritu


[Ann] Oxygen Terminology Checker add-on version 2.0.

Radu Coravu
 

Hi everyone,

We are glad to announce version 2.0 of our Terminology Checker add-on is now available in the Oxygen XML default add-on repository.

The add-on is free and is compatible with any Oxygen XML Editor or XML Author version 20.0 and newer.

To install the add-on, follow these instructions:

  1. Go to Help > Install new add-ons... to open an add-on selection dialog box.
  2. Select "Default Update Site" (or paste https://www.oxygenxml.com/InstData/Addons/default/updateSite.xml) in the Show add-ons from field.
  3. Select the Terminology Checker add-on and click Next.
  4. Select the I accept all terms of the end user license agreement option and click Finish.
  5. Restart the application.

Version 2.0 of the add-on brings these useful new features:

  • Partial support to load Vale rules and use them to highlight problems.

    Supported Vale scopes: heading, table.header, table.cell, list, paragraph, code,strong, emphasis.

    Supported Vale extension points: Existence, Substitution, Occurrence.

    For example, you can download the Microsoft style guide yaml rules and add them to the terminology folder configured in the Preferences->Plugins / Terminology Checker page.

  • The new Terminology Helper side view gives an overview of the terminology problems. Clicking in the side view on the incorrect term will focus the matching term in editor area.
  • Share favorite rules with the team: define a folder oxygen-term-checker in the root of your project and terms are automatically loaded from it.
  • Use capturing groups in the suggestions and messages in your custom term rules using the term match regular expression.
  • Match user defined custom terms at word level, character level or with a regular expression.
  • Insert replacement suggestion value as plain-text or as XML fragment.
  • Set problem severity (info, warning or error) for each matched term.
  • Enable/disable add-on from the tool bar without restarting Oxygen.

The screenshot below shows how the Terminology Helper side view displays various problems detected using the Vale Microsoft Style guide rules.

We hope you will find the plugin useful and as always any feedback is welcomed.

Best regards,

Radu

Radu Coravu

Oxygen XML Editor


Oxygen Content Fusion experiences

Michael McLoughlin
 

We're looking at Oxygen Content Fusion as a possible review tool. I'm looking for some experiences of folks who are using or have used it in the past.

Particularly, ease of installation and maintenance. Any info speed and general performance would also be gratefully received.

(Syncrosoft sales folks - we'll be in touch -  but we are just looking for user experiences for the moment).

Thanks!
--
Michael McLoughlin
Senior Technical Writer
Puppet


[ann][webinar] How practitioners can get published and ignite change with Pam Estes Brewer #Room42 Nov 11th @ 15:30 UTC #room42

Liz Fraley
 

Title: How practitioners can get published and ignite change

When: Wednesday, Nov 11th @ 15:30 UTC
(8:30 LAX | 11:30 NYC | 16:30 LON | 20:00 BLR)


Register: http://bit.ly/room42-brewer

Description:

Pam Estes Brewer will be In The Room!

Room 42 is where practitioners and academics meet to share knowledge about breaking research in an approachable, accessible way.

In our next session, Pam Estes Brewer, Mercer University, will be in the room.

Her research focuses on topics related to communication in virtual teams, online teaching, usability, and research methods. She teaches general technical communication courses as well as advanced and graduate courses in usability research, research methods, and international tech comm. She’ll be discussing how industry practitioners, who are working out on the front lines, can conduct reliable and valid research that can be published and instigate change in the workplace.

We're looking forward to exploring how industry experience can lead to publishable research in the next Room 42.


Pam Estes Brewer, Ph.D., Professor at Mercer University, is a technical communicator, educator, and management consultant. She teaches in Mercer University’s School of Engineering and directs the online MS in Technical Communication Management, the Mercer User Experience Lab and its work with such organizations as the Department of Homeland Security. She serves as an Associate Editor for IEEE Transactions on Professional Communication and as a board member for the Wesley Foundation of Macon.


-:-

The Room 42 is brought to you by Single-Sourcing Solutions. Learn more: http://room42.single-sourcing.com


Register: http://bit.ly/room42-brewer


Re: Variable text referenced using keys

Patricia Billard
 

Hi Kristen,

Thank you for the suggestion. I'll bring it up to the team.  We had not considered <text>, I think partly because the DITA 1.2 spec did not address variable elements in an obvious way if you weren't using keys.  The spec's suggestion also steered us away from looking at <text> for variables when we did our original migration:  "For contexts where ph is available, authors should use that element. Where keyword is available, authors should use that element. Where neither ph nor keyword is available, text can be used to pull content by conref." We also implemented some nested variables, in which the company name was referenced in the variable defined for the product name, for example.
The original discussion was a long time ago, but at the time <ph> seemed the best choice for most things, and we had a few other elements we allowed as variables, but I don't think we anticipated needing to use the company name in some of these situations. It might be a solution to use <text> for variables that we don't want to create multiple variable names for the same thing.
--Trish   


[ANN] Major new version of DITA-OT PDF plugin: looking for Beta testers

Corinna Kinchin
 

Dear DITA users,

 

Do you currently produce PDFs with DITA content? Would you be interested in testing a fully GUI PDF design and output tool? If so, please join our Beta testing program for the next major release of the MiramoPDF DITA-OT plugin, version 2.0. No matter whether you are an XSL-FO/XSLT expert, a graphic designer, or a content creator, we welcome your contribution! Active beta testers receive a FREE copy of MiramoPDF as well as a photo of some beautiful Irish cows as a thank-you for your efforts.


While testing, you’ll have a chance to explore powerful, easy-to-use features like:

 

  • GUI page layouts and image placement
  • GUI paragraph and character format assignment
  • Tagged PDF (PDF UA / accessibility)
  • Java job processing API
  • Packaged templates
  • HTTP access to images and packaged templates
  • OpenType font features
  • Videos in PDF output
  • Backend access to XSLT if needed for specialized processing

 

And more!

 

If you're interested, please email betaTest@.... Include your questions and some or all of the following information to help us provide you with the appropriate software:

 

Your name:

Company name:    [optional]

Test platform:   Windows, MacOS and/or Linux

DITA-OT version:

Some background info (such as current tool chain, experience with XSLT and XSL:FO, if any)

 

I'll look forward to welcoming you to the MiramoPDF version 2 beta program!


Corinna Kinchin,
Development Manager, Datazone Ltd, Kenmare, Kerry, Ireland
Tel: +353 64 66 289 64. ckinchin@...

 

 

MiramoPDF: "All the power, a tenth the time"

 

About us

MiramoPDF is a low-cost commercial solution that enables DITA users to produce PDF output without writing a line of XSL:FO or XSLT code.

Page layouts and all other formats, table layouts, paragraphs, etc, are controlled via a GUI.

 

Supported DITA-OT versions

        - 2.4 and above

 

Platforms

        - Windows  (Windows 10, Windows Server 2008 and above)

        - Linux *NEW* (Amazon AWS, CentOS 7, Oracle Linux 7.6)

        - MacOS *NEW* (Catalina)

 

361 - 380 of 46224