Date   

Any Interest in a Hardware Domain for Non-computer Buttons/Controls? #DITAv2-0

keith@...
 

Hello there:

An idea that is being floated for DITA 2.0 is the introduction of a new hardware domain to provide markup for things like the following:
- keyboard combinations like "Ctrl + Alt + Delete"
- a part number element to mark up part numbers
- a way to mark up non-computer controls, covering things like levers, peddles, switches having multiple selections, etc.
In general, the idea is to provide semantic alternatives for the arguably overused uicontrol element in situations that are not necessarily software related (say, for a control lever on a device, an accelerator or gear-shift for a car (which are forms of discrete controls), or a tuner knob on a radio (which is a continuous control)).

I was asked by the DITA TC to ask the members of this forum their thoughts on this idea in general, and whether people would use this markup if it was available.

If this is of interest, please respond! Whether or not we do this is dependant on the responses we get.

Cheers!

~~~~~~~~~~~~~~~~~~~~~~~~
Keith Schengili-Roberts
DITAWriter.com
Chair of OASIS DITA Adoption


Re: WebHelp test server for DITA project #HTML5 #Oxygen

Matt Lorenzi <mjlorenzi@...>
 

Thanks to both of you, this should give me enough for IT to do something with. Yes we do use Sharepoint and One Drive so that may be a solution.


Re: WebHelp test server for DITA project #HTML5 #Oxygen

Thomas Rathkamp
 

Hi Matt,

IT set it up for me but I do not think it was that involved.  It is connected to One Drive so I can upload updates via Windows Explorer. If your company does not use Sharepoint, then I would definitely look into Radu's suggestions in his reply to you. 

Tom Rathkamp
Senior Technical Writer




On Tuesday, March 24, 2020, 10:16:59 PM CDT, Matt Lorenzi via Groups.Io <mjlorenzi@...> wrote:


I'm not sure, how easy is it to publish a website to Sharepoint?


Re: Using roboto font #PDF #DITA-OT

ronny.flink@...
 

Thank you all for your replies,

The problem is solved, thanks this email reply below: 😎

“Are you on Windows? If so, make sure you have installed the font for all users. Right-click the font name in Window Explorer and choose Install for all users. Oxygen seems to run under the administrator user.
 
We just struggled with this same issue when getting a new writer up and running on Windows (I’m on Mac)”

I’m on Windows, so what I did was download the font again and right click “Install for all users”

Best regards
Ronny


Re: Using roboto font #PDF #DITA-OT

Kristen James Eberlein
 

I have used Roboto as the font for PDF plug-ins without any problems.

Have you:

  • Verified that the Roboto fonts are installed on the system where DITA-OT installed?
  • Examined the DITA-OT log to see if there are errors about fonts not being found?
  • Correctly specified Roboto in the font mappings file?
  • Correctly specified the font mappings file in the catalog file?

Thank you for making me aware of the Oxygen resource about PDF customization; I was not aware of it.

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 3/24/2020 2:13 PM, ronny.flink@... wrote:
Dear DITA users,
Please, I hope anyone here can help me, because this is making me go insane.
I’m trying to publish a PDF with the Roboto using DITA-OT 3.3.1 and FOP.
I have tried to follow this step by step: https://github.com/oxygenxml/com.oxygenxml.pdf2.ug/wiki/Custom-fonts
But without any success, feels like I have made every minor tweak a hundred times. The font-mapping works and I can get fonts like Tahoma or Trebucet in the PDF output.
Also tried all kinds of changes to the fop.xconf.
If anyone of you have made Roboto font work with FOP, please share.

Best regards
Ronny


Re: WebHelp test server for DITA project #HTML5 #Oxygen

Radu Coravu
 

Hi Matt,

One solution is to have an internal server with an Apache HTTP Server or ‪Firefly‬ installed on it to serve your static HTML pages.

Another solution is to use a hosted solution like Netlify. You create an account in Netlify using your gmail address for example and if you have on the local disk the folder containing the WebHelp HTML output you can drag and drop it in the web page:

https://app.netlify.com/drop

Netlify can also be used to automate the publishing of DITA content to outputs like WebHelp or PDF and it can connect to a GitHub repository with DITA content, detect changes in it and launch a publishing script to automatically update the published outputs, like I did for the Oxygen XML Blog:

https://oxygenxmlblog.netlify.com/topics/welcome.html

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 3/24/20 10:24 PM, Matt Lorenzi via Groups.Io wrote:

I am looking for some technical information for a Webhelp test environment. I am looking to showcase Webhelp produced with OxygenXML Author to internal stakeholders.
What kind of server setup would be best for a testing environment; also would I need a publishing client to publish to the host?

I realize this is not really DITA specific, but since I am writing in a DITA environment using OxygenXML, this would be a good place to ask. Also I need to give my IT people some technical sounding information to help move this along.


  


Re: Using roboto font #PDF #DITA-OT

Ron Wheeler
 

What operating system are you using to produce the PDF?
Are you sure that Roboto is installed on your computer?
Ron

On 2020-03-24 2:13 p.m., ronny.flink@... wrote:
Dear DITA users,
Please, I hope anyone here can help me, because this is making me go insane.
I’m trying to publish a PDF with the Roboto using DITA-OT 3.3.1 and FOP.
I have tried to follow this step by step: https://github.com/oxygenxml/com.oxygenxml.pdf2.ug/wiki/Custom-fonts
But without any success, feels like I have made every minor tweak a hundred times. The font-mapping works and I can get fonts like Tahoma or Trebucet in the PDF output.
Also tried all kinds of changes to the fop.xconf.
If anyone of you have made Roboto font work with FOP, please share.

Best regards
Ronny


Re: WebHelp test server for DITA project #HTML5 #Oxygen

Matt Lorenzi <mjlorenzi@...>
 

I'm not sure, how easy is it to publish a website to Sharepoint?


Re: pass parameter using command line #DITA-OT

scott ashmead
 

Thank You!

On Tuesday, March 24, 2020, 09:23:24 PM EDT, Mark Giffin <mark@...> wrote:


Hi Scott,

I assume you are using a late-model DITA OT. Usually you can use the Java-style -Dnn syntax for extra command line parameters, like this example for the clean.temp parameter:

dita -f html5 -i path/to/mymap.ditamap -Dclean.temp=no

This sets clean.temp to no. This style is described here:

https://www.dita-ot.org/3.4/topics/build-using-dita-command.html

If your parameter is custom to your code, the parameter needs to be made available on the command line, and to do that there is an extra step, covered here:

https://www.dita-ot.org/3.4/topics/plugin-xsltparams.html

This works in a similar manner in 2.x versions of the OT. And even earlier!

Mark Giffin
Mark Giffin Consulting, Inc.
http://markgiffin.com/


On 3/24/2020 3:37 PM, scott ashmead via Groups.Io wrote:
Hi DITA users

Does anyone know of a way to pass in a parameter value from the DITA-OT command line?

Currently the param is hard-coded in the XSLT, but I'd like to have the flexibility to modify it.

This is how the param is defined in the XSLT...<xsl:param name="xyz" as="xs:string" select="'file:///c:/temp/xyz.xml'"/>

Regards,
Scott


Re: pass parameter using command line #DITA-OT

Mark Giffin
 

Hi Scott,

I assume you are using a late-model DITA OT. Usually you can use the Java-style -Dnn syntax for extra command line parameters, like this example for the clean.temp parameter:

dita -f html5 -i path/to/mymap.ditamap -Dclean.temp=no

This sets clean.temp to no. This style is described here:

https://www.dita-ot.org/3.4/topics/build-using-dita-command.html

If your parameter is custom to your code, the parameter needs to be made available on the command line, and to do that there is an extra step, covered here:

https://www.dita-ot.org/3.4/topics/plugin-xsltparams.html

This works in a similar manner in 2.x versions of the OT. And even earlier!

Mark Giffin
Mark Giffin Consulting, Inc.
http://markgiffin.com/


On 3/24/2020 3:37 PM, scott ashmead via Groups.Io wrote:
Hi DITA users

Does anyone know of a way to pass in a parameter value from the DITA-OT command line?

Currently the param is hard-coded in the XSLT, but I'd like to have the flexibility to modify it.

This is how the param is defined in the XSLT...<xsl:param name="xyz" as="xs:string" select="'file:///c:/temp/xyz.xml'"/>

Regards,
Scott


pass parameter using command line #DITA-OT

scott ashmead
 

Hi DITA users

Does anyone know of a way to pass in a parameter value from the DITA-OT command line?

Currently the param is hard-coded in the XSLT, but I'd like to have the flexibility to modify it.

This is how the param is defined in the XSLT...<xsl:param name="xyz" as="xs:string" select="'file:///c:/temp/xyz.xml'"/>

Regards,
Scott


Re: WebHelp test server for DITA project #HTML5 #Oxygen

Thomas Rathkamp
 

We use Sharepoint, mainly because it was already in use for other purposes where I work.  



Tom Rathkamp
Senior Technical Writer




On Tuesday, March 24, 2020, 03:24:24 PM CDT, Matt Lorenzi via Groups.Io <mjlorenzi@...> wrote:


I am looking for some technical information for a Webhelp test environment. I am looking to showcase Webhelp produced with OxygenXML Author to internal stakeholders.
What kind of server setup would be best for a testing environment; also would I need a publishing client to publish to the host?

I realize this is not really DITA specific, but since I am writing in a DITA environment using OxygenXML, this would be a good place to ask. Also I need to give my IT people some technical sounding information to help move this along.


WebHelp test server for DITA project #HTML5 #Oxygen

Matt Lorenzi <mjlorenzi@...>
 

I am looking for some technical information for a Webhelp test environment. I am looking to showcase Webhelp produced with OxygenXML Author to internal stakeholders.
What kind of server setup would be best for a testing environment; also would I need a publishing client to publish to the host?

I realize this is not really DITA specific, but since I am writing in a DITA environment using OxygenXML, this would be a good place to ask. Also I need to give my IT people some technical sounding information to help move this along.


Using roboto font #PDF #DITA-OT

ronny.flink@...
 

Dear DITA users,
Please, I hope anyone here can help me, because this is making me go insane.
I’m trying to publish a PDF with the Roboto using DITA-OT 3.3.1 and FOP.
I have tried to follow this step by step: https://github.com/oxygenxml/com.oxygenxml.pdf2.ug/wiki/Custom-fonts
But without any success, feels like I have made every minor tweak a hundred times. The font-mapping works and I can get fonts like Tahoma or Trebucet in the PDF output.
Also tried all kinds of changes to the fop.xconf.
If anyone of you have made Roboto font work with FOP, please share.

Best regards
Ronny


Re: Filter on Topics Reused with Keys #branch-filtering #keys

@l3arn4life
 

Hi Radu,

that did the trick, thanks.

Regards,
Ed


Re: OT processing for troubleshooting topic #DITA-OT #troubleshooting

Larry Kollar
 

We implemented troubleshooting topics ourselves at work. A couple of differences from Bob's examples:

  • Titles are inserted automatically, removing one potential point of inconsistency. Adding a <title> element overrides the automatic one.
  • We support @outputclass="message" on the troubleshooting topic itself. It occurred to me that a log/alarm message has a condition (the log itself), cause, and remedy. So we use the condition section to describe the message format, and the plugin changes the "Condition" title to "Format" (unless, again, the writer inserts a title).
  • Our core team constrained out <responsibleParty>. No complaints so far.
The core team also developed several templates, to cover anticipated scenarios with multiple solutions.


Re: Filter on Topics Reused with Keys #branch-filtering #keys

Radu Coravu
 

Hi Ed,

In order to run the sample I gave you I used Oxygen 22.0 and DITA OT 3.4.
I did not test with older DITA OT distributions.

Regards,
Radu

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

On 3/19/2020 3:00 PM, schmidt.eduard@gmail.com wrote:
Hi Radu,
thank you for your help. Somehow though, when running a transformation on your modified sample, the output came up empty.
Changing the root map to any of the submaps containing the reference to "topicKeys.ditamap" didn’t help.
Could it be that once the publishing engine sees a /.ditaval/ it will attempt to do its branch filtering but will pretty much abort the entire process in the absence of a direct topicref?
In any case, the processing order of the publishing engine seems to forbid the combination of branch-filtering and keyrefs, which I find a pity.
Or am I missing something?
Sincerely,
Ed


Re: Filter on Topics Reused with Keys #branch-filtering #keys

@l3arn4life
 

Hi Radu,

thank you for your help. Somehow though, when running a transformation on your modified sample, the output came up empty.
Changing the root map to any of the submaps containing the reference to "topicKeys.ditamap" didn’t help.
Could it be that once the publishing engine sees a .ditaval it will attempt to do its branch filtering but will pretty much abort the entire process in the absence of a direct topicref?
In any case, the processing order of the publishing engine seems to forbid the combination of branch-filtering and keyrefs, which I find a pity.
Or am I missing something?

Sincerely,
Ed


Re: Filter on Topics Reused with Keys #branch-filtering #keys

Radu Coravu
 

Hi Ed,

Thanks for the samples.
The publishing engine first does the branch filtering and then the keyref processing so the only way to make this work was to refer to the "topicKeys.ditamap" in each ditavalref context.
This is not necessarily a bug in the publishing engine, I don't think the specification says precisely how such cases, branch-filtering in combination with keyref should be handled.
I'm attaching a modified project, you can compare it with your own using Oxygen's Compare Directories tool.

Regards,
Radu

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

On 3/19/2020 10:38 AM, schmidt.eduard@gmail.com wrote:
Good morning,
thank you Pieterjan for providing a sample, I will look at it. Sorry for the delayed response, an approaching deadline kept me from getting back earlier. Radu, I attached a sample project and included responsive webhelp output that demonstrates the problem. I yet have to test this with the current DITA-OT.
Regards, Ed


Re: Filter on Topics Reused with Keys #branch-filtering #keys

@l3arn4life
 

Good morning,

thank you Pieterjan for providing a sample, I will look at it. Sorry for the delayed response, an approaching deadline kept me from getting back earlier. Radu, I attached a sample project and included responsive webhelp output that demonstrates the problem. I yet have to test this with the current DITA-OT.

Regards, Ed

941 - 960 of 46276