Date   

Re: Custom dita-ot plugins directory in configuration.properties #DITA-OT

Radu Coravu
 

Hi Nicolas,

So in the Oxygen Preferences->DITA page you set the DITA OT engine to point to your custom DITA OT folder, right?

Not sure what the problem is, if you want further help maybe you can contact us directly (support@...) and give us some steps to reproduce the problem on our side.

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 2/2/21 10:06, Nicolas Delobel wrote:

Hi Radu,

I made a test with oXygen 23 but unfortunately I still have an error message:

Buildfile: C:\myproject\dita-ot-3.6-oxy23\build.xml

BUILD FAILED
C:\myproject\dita-ot-3.6-oxy23\build.xml:19: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6-oxy23\plugins\org.dita.base\build.xml:36: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6-oxy23\plugins\org.dita.base\build_init.xml:23: taskdef class org.dita.dost.ant.InitializeProjectTask cannot be found
 using the classloader AntClassLoader[]

Total time: 0 seconds

The process finished with exit code: 1

Regards,
Nicolas

  


Re: Any one using Oxygen as an editor with an AEM XML Documentation solution?

Julio J Vazquez
 

Sure, Kris, we can talk. I'm not sure how helpful I would be, but I think the discussion would be beneficial. I think you still have my personal email, so send me some proposed times. 

Julio J. Vazquez


Re: Any one using Oxygen as an editor with an AEM XML Documentation solution?

John Piechowski
 

Kristen,

I tried to use Oxygen and the connector implementation is buggy and clunky. It doesn't always lock/unlock as you would expect and if you try to check out an entire map to edit the whole book, it doesn't always download all the assets. Ultimately, we decided to stay in the AEM Editor. With the latest update it's a pretty good experience, although I understand what you're saying about <alt> - maybe you could get Adobe to get <alt> into the product...

John

On Tue, Feb 2, 2021 at 7:19 AM Kristen James Eberlein <kris@...> wrote:

Hi, Julio. Are you up for having a brief conversation about this? I'm concerned about the user experience for NON-POWER USERS. As far as I can tell, using Oxygen though WebDAV bypasses a lot of AEM version control. It gives a solid Oxygen authoring experience -- and I can see that authors can lock and unlock objects -- but if authors move objects around there will be a lot of broken references.

Your thoughts? And those of any others with input.

The only reason I am considering Oxygen XML Editor is that the built-in AEM Web editor does not display the <alt> element. I don't want to force content authors to enter the code view in order to add alternate text for an image.

Yes, the AEM built-in Web editor enables content authors to add alternate text for images using the @alt attribute, but the @alt attribute has been deprecated since 2010 and is removed in DITA 2.0. I TRULY HATE to encourage a brand-new DITA implementation to use a deprecated feature ...

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)


On 2/2/2021 6:47 AM, Julio J Vazquez via groups.io wrote:
Hi Kristen,

I'm raising my hand. 

Julio J. Vazquez


Re: Any one using Oxygen as an editor with an AEM XML Documentation solution?

Kristen James Eberlein
 

Hi, Julio. Are you up for having a brief conversation about this? I'm concerned about the user experience for NON-POWER USERS. As far as I can tell, using Oxygen though WebDAV bypasses a lot of AEM version control. It gives a solid Oxygen authoring experience -- and I can see that authors can lock and unlock objects -- but if authors move objects around there will be a lot of broken references.

Your thoughts? And those of any others with input.

The only reason I am considering Oxygen XML Editor is that the built-in AEM Web editor does not display the <alt> element. I don't want to force content authors to enter the code view in order to add alternate text for an image.

Yes, the AEM built-in Web editor enables content authors to add alternate text for images using the @alt attribute, but the @alt attribute has been deprecated since 2010 and is removed in DITA 2.0. I TRULY HATE to encourage a brand-new DITA implementation to use a deprecated feature ...

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)


On 2/2/2021 6:47 AM, Julio J Vazquez via groups.io wrote:
Hi Kristen,

I'm raising my hand. 

Julio J. Vazquez


Re: Any one using Oxygen as an editor with an AEM XML Documentation solution?

Julio J Vazquez
 

Hi Kristen,

I'm raising my hand. 

Julio J. Vazquez


Re: Custom dita-ot plugins directory in configuration.properties #DITA-OT

Nicolas Delobel
 

Hi Radu,

I made a test with oXygen 23 but unfortunately I still have an error message:

Buildfile: C:\myproject\dita-ot-3.6-oxy23\build.xml

BUILD FAILED
C:\myproject\dita-ot-3.6-oxy23\build.xml:19: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6-oxy23\plugins\org.dita.base\build.xml:36: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6-oxy23\plugins\org.dita.base\build_init.xml:23: taskdef class org.dita.dost.ant.InitializeProjectTask cannot be found
 using the classloader AntClassLoader[]

Total time: 0 seconds

The process finished with exit code: 1

Regards,
Nicolas


Re: Custom dita-ot plugins directory in configuration.properties #DITA-OT

Radu Coravu
 

Hi Nicolas,

I agree the problem was in Oxygen not properly detecting libraries in external DITA OT plugins folders.

If you get a chance to test the fix in Oxygen 23 please tell us if it works better or not.

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 2/1/21 14:48, Nicolas Delobel wrote:

Thanks Pierre,

Indeed, it's linked to Oxygen (see topic about this issue on oXygen forum: https://www.oxygenxml.com/forum/post60146.html?hilit=configuration.properties#p60146)
It seems to be corrected on Oxygen 23. I didn't test yet.

When I run the transformation outside of oXygen with dita-ot command line, it works.

Nicolas

  


Re: Any one using Oxygen as an editor with an AEM XML Documentation solution?

Tonia
 

We are, sorta. There is no integration between the two. We only download manually and work in Oxygen when we have a gnarly topic or a lot of work to do quickly.

On Feb 1, 2021, at 2:44 PM, Kristen James Eberlein <kris@eberleinconsulting.com> wrote:

Let me know, please. Thanks!

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)








Any one using Oxygen as an editor with an AEM XML Documentation solution?

Kristen James Eberlein
 

Let me know, please. Thanks!

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: Custom dita-ot plugins directory in configuration.properties #DITA-OT

Nicolas Delobel
 

Thanks Pierre,

Indeed, it's linked to Oxygen (see topic about this issue on oXygen forum: https://www.oxygenxml.com/forum/post60146.html?hilit=configuration.properties#p60146)
It seems to be corrected on Oxygen 23. I didn't test yet.

When I run the transformation outside of oXygen with dita-ot command line, it works.

Nicolas


Re: ResolvedValues log file? was Allow variables to be referenced from @scope="peer" maps

David Hollis
 

Hi Eliot,

The DITA-OT obviously has to resolve all the reuse mechanisms, and related content.

How feasible would it be to tap into this process, and for the DITA-OT to produce a log file of all the resolved content? Maybe as part of a build, or as its own build.

Something like:

map id: topic id: element name: scope or branch: keys or ditaval: resolved content

Many thanks,
David

This is an example of where a local, targeted solution is relatively easy (just a bit of preprocessing or relying on knowledge of cases that won't occur in your content) but the general solution would be hard (because it has to handle all cases, perform well, be extensible, report exception conditions clearly, etc.).

It's not hard to implement simple processes that operate on maps and do specific things, either using the output of the OT preprocessing stage or just operating on the maps directly if you know you don't need to worry about stuff like filtering, metadata propagation, etc.

The DITA Community utilities area on github has general XSLT scripts for operating on maps, including resolving key references and resolving topicrefs to topics. With that code as a base it should be as easy as it can be to extract topic titles or book titles.https://github.com/dita-community/dita-utilities/tree/master/src/xslt

Then, as you say, it's a matter of optimizing performance: do you do the processing every time or cache results? If you cache results, how do you keep the cache up to date?

Cheers,

E.

--
Eliot Kimber
http://contrext.com


Re: Custom dita-ot plugins directory in configuration.properties #DITA-OT

Pierre Attar
 

This seems to be related to java version used by 3.6 which is different from the one used by oXygen.

Pierre


Le 1 février 2021 11:49:02 GMT+01:00, Nicolas Delobel <nicolas.delobel@...> a écrit :
Hello all,

I developed custom plugins and stored them in a specific directory: c:/myplugins

Following https://www.dita-ot.org/dev/parameters/configuration-properties-file.html I added following line in configuration.properties (dita-ot 3.6):
plugindirs = plugins;demo;C:/myplugins;

When I run dita-ot integrator, I have following messages so it's OK:
integrate:
[integrate] Added com.myplugin1.pdf
[integrate] Added com.myplugin2.pdf
[integrate] Added com.myplugin3.pdf
...

But when I try to use one of these plugins I immediately have:
BUILD FAILED
C:\myproject\dita-ot-3.6\build.xml:19: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6\plugins\org.dita.base\build.xml:36: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6\plugins\org.dita.base\build_init.xml:23: taskdef class org.dita.dost.ant.InitializeProjectTask cannot be found
 using the classloader AntClassLoader[]

Did you already have this kind of issue?

Thanks.

Nicolas

--
Envoyé de mon appareil mobile


Custom dita-ot plugins directory in configuration.properties #DITA-OT

Nicolas Delobel
 

Hello all,

I developed custom plugins and stored them in a specific directory: c:/myplugins

Following https://www.dita-ot.org/dev/parameters/configuration-properties-file.html I added following line in configuration.properties (dita-ot 3.6):
plugindirs = plugins;demo;C:/myplugins;

When I run dita-ot integrator, I have following messages so it's OK:
integrate:
[integrate] Added com.myplugin1.pdf
[integrate] Added com.myplugin2.pdf
[integrate] Added com.myplugin3.pdf
...

But when I try to use one of these plugins I immediately have:
BUILD FAILED
C:\myproject\dita-ot-3.6\build.xml:19: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6\plugins\org.dita.base\build.xml:36: The following error occurred while executing this line:
C:\myproject\dita-ot-3.6\plugins\org.dita.base\build_init.xml:23: taskdef class org.dita.dost.ant.InitializeProjectTask cannot be found
 using the classloader AntClassLoader[]

Did you already have this kind of issue?

Thanks.

Nicolas


[ann][webinar] Working with DITA in Oxygen - Advanced Profiling and Reuse Strategies (3 February) #Oxygen

alin_belu@...
 

Hello, 
 
If becoming advanced in profiling and reusing DITA content is one of this year’s resolutions, then you're in luck!  
 
Next Wednesday (February 3), make time for the third installment of the “Working with DITA in Oxygen” webinar series. In this live event titled “Advanced Profiling and Reuse Strategies”, Sorin Carbunaru (software developer at Syncro Soft) returns to help you achieve mastery in more advanced DITA concepts, such as: 
* Conref ranges – easily create content references to ranges of adjacent (sibling) elements. 
* Conref push - an alternate way of creating content references by injecting element values from the source element into a topic where it is to be re-used. 
* Subject scheme maps - create custom controlled values and manage metadata attribute values for an organization or a project without having to write a DITA specialization. 
* Profiling attribute groups - used to support situations where an attribute applies to multiple specialized subcategories. 
* Key scopes - specify different sets of key definitions for different map branches. 
* Branch filtering - set filtering conditions for specific branches of a map. 
 
This is a free event and you can register at http://www.oxygenxml.com/evs2021-3.html 
 
Make sure to check the full list of our upcoming events: https://www.oxygenxml.com/events_programme.html  
 
Best regards,
Alin
--
Alin Belu
Oxygen XML Editor


Re: PHP microservice using dita #HTML5

despopoulos_chriss
 

As a different solution (not necessarily better), we do the DITA to HTML transform in the browser.  (This is also what Michael Kay does with DocBook, in his own way for his own docs.)  We support a subset of DITA that is roughly equivalent to LwDITA, but it's all a matter of what you support in the XSLT.  The one thorny issue is that we have to do a one-step transform...  No pre/post passes. This has proved to be a problem with conrefs to things like table rows. 

The good news is that it's very light-weight.  On the server side, it's essentially a static site.  It also seems to be quicker than calling the OT.  In my ignorant innocence, I tried transforming single topics via the OT before turning to client-side transforms.  Because of the multiple passes, the performance seemed sluggish.  It could just be that I don't know the optimal way to invoke the OT. 

Other good news is that we can integrate into our HTML GUI.  So we use the same code to present microcontent in the GUI. 

See it here:
https://docs.turbonomic.com/docApp/doc/index.html?config=8.0.json


Re: PHP microservice using dita #HTML5

Jingjun Long
 

hi Jack,

I assume there will be multiple requests from Web browser to render XML to HTML output. I.e.: there will be multiple instances of converting XML to HTML running concurrently. I think your approach (Create a web service in Java to call Data-OT)  is a good approach.  

To call DITA-OT from Java program is documented here: https://www.dita-ot.org/dev/reference/java-api.html

Can you show the detail error message you got?

J.J. 


On Jan 27, 2021, at 3:41 PM, jack10086007@... wrote:

Hi Don,

Thank you so much for your reply!

Yes, it is currently just a single topic/concept, not even require formatting.

What I have tried so far:

1. Created a controller through the maven project, and inside PHP fetched that endpoint. However, I failed to use Java API as shown on the doc. Error message was 'Transtype xhtml not supported'.

2. Then, I was currently trying to wrap everything inside docker but was blocked by setting up JAVA HOME environment variable.

 

May I please ask if you have any better solutions? Thank you very much and wish you could have a lovely night!

Cheers,
Jack



Re: PHP microservice using dita #HTML5

Radu Coravu
 

Hi Jack,

I also replied to you on Slack, about using the Java API to start the DITA OT:

There is more information about making this work here:
https://github.com/dita-ot/dita-ot/issues/3647
The “dost.jar” is useful for compiling your Java code but for running you need an entire DITA OT distribution

If I were you I would maybe consider running the DITA OT command line directly as an external process from the PHP script. So you would need a DITA OT downloaded and available on the server side.

Or as another alternative you can create a Java wrapper which starts the DITA OT as a separate process and create a service wrapper around it.

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 1/27/21 09:41, jack10086007@... wrote:

Hi Don,

Thank you so much for your reply!

Yes, it is currently just a single topic/concept, not even require formatting.

What I have tried so far:

1. Created a controller through the maven project, and inside PHP fetched that endpoint. However, I failed to use Java API as shown on the doc. Error message was 'Transtype xhtml not supported'.

2. Then, I was currently trying to wrap everything inside docker but was blocked by setting up JAVA HOME environment variable.

 

May I please ask if you have any better solutions? Thank you very much and wish you could have a lovely night!

Cheers,
Jack


  


Re: PHP microservice using dita #HTML5

jack10086007@...
 

Hi Don,

Thank you so much for your reply!

Yes, it is currently just a single topic/concept, not even require formatting.

What I have tried so far:

1. Created a controller through the maven project, and inside PHP fetched that endpoint. However, I failed to use Java API as shown on the doc. Error message was 'Transtype xhtml not supported'.

2. Then, I was currently trying to wrap everything inside docker but was blocked by setting up JAVA HOME environment variable.

 

May I please ask if you have any better solutions? Thank you very much and wish you could have a lovely night!

Cheers,
Jack


Re: PHP microservice using dita #HTML5

Don Day
 

I assume you are talking about rendering single topics on demand rather than initiating the usual map-driven build and thereafter serving HTML files statically out of a built folder. Converting single topics on demand using PHP is necessarily short of that full normal build view, but some degree of dynamically customized output is possible. What are the goals of your project, and how closely do you require a fully contemporary DITA output result?

--
Don Day

On 1/26/2021 2:40 AM, jack10086007@... wrote:
Hi,

I am currently working on a project, which is to use PHP to call a method which is to convert existing dita file to html5. May I get any suggestions? Thank you!

Cheers,
Jack



Avast logo

This email has been checked for viruses by Avast antivirus software.
www.avast.com



PHP microservice using dita #HTML5

jack10086007@...
 

Hi,

I am currently working on a project, which is to use PHP to call a method which is to convert existing dita file to html5. May I get any suggestions? Thank you!

Cheers,
Jack

241 - 260 of 46224