Date   

Re: non-breaking period?

Wayne Brissette
 

Try putting this in in the text editor:

⁠

so if you had 'word1' and 'word2' it would look like this:
word1
⁠word2

-Wayne
CharJTF wrote on 2020-04-28 11:18:

Hi, Bill :-)

I opened Character Map on both my work laptop and my personal laptop, and U+2060 doesn't exist on either. I'm not sure what else to try.

Char



Re: non-breaking period?

CharJTF
 

Hi, Bill :-)

I opened Character Map on both my work laptop and my personal laptop, and U+2060 doesn't exist on either. I'm not sure what else to try.

Char

On Mon, Apr 27, 2020 at 3:11 PM Bill Burns <wdburns63@...> wrote:

> I'm using Arbortext and can't figure out how to insert a non-breaking joiner. It dings when I try :-)

 

Should be able to copy it directly from the Character Map and paste it in. You might need to switch to text view to insert it that way. Or you can check the Special Character catalog and see if it’s available there. It’s been a while since I’ve used Arbortext. In Oxygen, it’s a breeze.

 

Bill

wdburns63@...


Virus-free. www.avast.com


Re: non-breaking period?

Bill Burns
 

> I'm using Arbortext and can't figure out how to insert a non-breaking joiner. It dings when I try :-)

 

Should be able to copy it directly from the Character Map and paste it in. You might need to switch to text view to insert it that way. Or you can check the Special Character catalog and see if it’s available there. It’s been a while since I’ve used Arbortext. In Oxygen, it’s a breeze.

 

Bill

wdburns63@...


Virus-free. www.avast.com


Re: non-breaking period?

CharJTF
 

Hi, Bill :-)

Thanks!

I'm using Arbortext and can't figure out how to insert a non-breaking joiner. It dings when I try :-)

Char

On Mon, Apr 27, 2020 at 2:00 PM Bill Burns <wdburns63@...> wrote:

Char asks:

 

>Does anyone know of a solution? I'm not aware of any character called "non-breaking period".

 

Maybe try inserting a non-breaking joiner (U+2060)?

 

Bill Burns

wdburns63@...

+1.208.794.5709

 


Virus-free. www.avast.com


Re: non-breaking period?

Bill Burns
 

Char asks:

 

>Does anyone know of a solution? I'm not aware of any character called "non-breaking period".

 

Maybe try inserting a non-breaking joiner (U+2060)?

 

Bill Burns

wdburns63@...

+1.208.794.5709

 


Virus-free. www.avast.com


non-breaking period?

CharJTF
 

Hi :-)

I've tried a number of things to try to keep a version number together (for example, "3.x") when a) it's included in a topic title and b) the topic is the target of an <xref>.

I've added <_nolinebreak> around the version in the title, but it's being ignored in the <xref>. The version number is split across lines, with "3." on one line and "x" on the next.

Does anyone know of a solution? I'm not aware of any character called "non-breaking period".

Thanks!

Char


Re: Topichead usage and best practice #bookmap

Bill Burns
 

That was obviously supposed to say “Ronny Flink wrote”—sheesh.

 

 


Virus-free. www.avast.com


Re: Topichead usage and best practice #bookmap

Bill Burns
 

Ronny Flink write:

 

> I stopped using <topichead> after read the DITA style guide, by Tony Self. I also had problems with untranslated titles, when forgot to send <topichead> content to translation.

 

As with all such determinations, it depends (the consultants’ favorite response). I was always a strong proponent of using only the title and titlealts from the topic, in part, because it’s easier to maintain consistency in translation. That said, I have come across use cases in which different titles are needed depending on the type of deliverable—often more than just the single navigation title allows. The best way to handle them, for these use cases, was to use topicheads. In these cases the ONLY title being used was the navtitle in the topichead/topicmeta. Topic titles and any topic titlealts were ignored.

 

So my advice would be to determine what’s best for your use case and for maximum reuse.

 

Bill Burns

wdburns63@...

+1.208.794.5709

 

From: main@dita-users.groups.io <main@dita-users.groups.io> On Behalf Of ronny.flink@...
Sent: Monday, April 27, 2020 8:29 AM
To: main@dita-users.groups.io
Subject: Re: [dita-users] Topichead usage and best practice #bookmap

 

Hi,
I stopped using <topichead> after read the DITA style guide, by Tony Self. I also had problems with untranslated titles, when forgot to send <topichead> content to translation.

” There are two main reasons why topichead elements should be avoided. The first is that it conflicts with the notion of the separation of content and form, and the separation of data and metadata. All content (data) in a document should reside in the topics, not in the map. The ditamap should only contain metadata. If you use topichead as an alternative to a title-only topic, you are effectively placing non-reusable content, or data, in the ditamap. The second reason is more practical. If you are transforming a ditamap to a hypertext output format with a TOC, such as to Eclipse Help, the topichead elements will be transformed to unlinked parent nodes in the TOC. When the user clicks on such a node, the content pane will not display an associated topic, as it will for other nodes in the TOC. This inconsistency appears to the user to be an error. The unlinked node in the TOC will also cause inconsistencies or malfunctions in the way breadcrumbs function, and the way sequences (previous and next topic links) function.”


best regards
Ronny


Virus-free. www.avast.com


Re: Topichead usage and best practice #bookmap

ronny.flink@...
 

Hi,
I stopped using <topichead> after read the DITA style guide, by Tony Self. I also had problems with untranslated titles, when forgot to send <topichead> content to translation.

” There are two main reasons why topichead elements should be avoided. The first is that it conflicts with the notion of the separation of content and form, and the separation of data and metadata. All content (data) in a document should reside in the topics, not in the map. The ditamap should only contain metadata. If you use topichead as an alternative to a title-only topic, you are effectively placing non-reusable content, or data, in the ditamap. The second reason is more practical. If you are transforming a ditamap to a hypertext output format with a TOC, such as to Eclipse Help, the topichead elements will be transformed to unlinked parent nodes in the TOC. When the user clicks on such a node, the content pane will not display an associated topic, as it will for other nodes in the TOC. This inconsistency appears to the user to be an error. The unlinked node in the TOC will also cause inconsistencies or malfunctions in the way breadcrumbs function, and the way sequences (previous and next topic links) function.”


best regards
Ronny


Re: PDF page numbering question (embedded pagination) #PDF

David H
 

Hi Erik,

You might look at JavaScript, as Acrobat has very good support for it. It's possible to get and set page labels.

HTH,
David


Hello everyone,

I have a customer that has asked about customizing the page numbers embedded in the PDF metadata. To be clear, I am not talking about customizing the page numbers as they are rendered in the PDF. I am talking about the actual page numbers that appear in the page number field in an application like Acrobat.

I believe they are currently editing these manually using Word, and I know how to set them in Acrobat by adding a prefix.

I am wondering if it is possible to somehow pass the fo:page-number information to Antenna House at publish time and have Antenna House also customize these page numbers at publish time without having to manually do so after the fact.

So far, I have not found any resources that say that this is even possible, let alone how to accomplish it. I'm hoping that someone here can at least tell me if this is at all possible... I don't need a solution (although that would be greatly appreciated!). I just need to know whether I'm on a fool's errand looking into this at all.

Even just a simple yes/no this is/isn't possible would help me get over this current block.

Thanks in advance!

Erik_._,_._,_


Re: PDF page numbering question (embedded pagination) #PDF

Toshihiko Makita
 

Hi Erik,

I'm not sure what the concrete problem is.

If your question is about PDF, I believe that the PDF page count is stored in PDF file as the static data. But page count does not belong to metadata such like title, author, subtitle, keywords common in PDF documents. 

If your question is about Microsoft Word .docx, the page number is stored in docProps/app.xml such like below:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties"
    xmlns:vt="http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes">
    <Template>Normal.dotm</Template>
    <TotalTime>2291</TotalTime>
    <Pages>23</Pages>
    <Words>3752</Words>
    <Characters>21391</Characters>
    <Application>Microsoft Office Word</Application>
    <DocSecurity>0</DocSecurity>
    <Lines>178</Lines>
    <Paragraphs>50</Paragraphs>
    <ScaleCrop>false</ScaleCrop>
    ...
</Properties>

And this property is maintained by Microsoft Word itself. There is no need to maintain by authors.
What is your goal?

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


PDF page numbering question (embedded pagination) #PDF

Erik
 

Hello everyone,

I have a customer that has asked about customizing the page numbers embedded in the PDF metadata. To be clear, I am not talking about customizing the page numbers as they are rendered in the PDF. I am talking about the actual page numbers that appear in the page number field in an application like Acrobat.

I believe they are currently editing these manually using Word, and I know how to set them in Acrobat by adding a prefix.

I am wondering if it is possible to somehow pass the fo:page-number information to Antenna House at publish time and have Antenna House also customize these page numbers at publish time without having to manually do so after the fact.

So far, I have not found any resources that say that this is even possible, let alone how to accomplish it. I'm hoping that someone here can at least tell me if this is at all possible... I don't need a solution (although that would be greatly appreciated!). I just need to know whether I'm on a fool's errand looking into this at all.

Even just a simple yes/no this is/isn't possible would help me get over this current block.

Thanks in advance!

Erik


Re: Topichead usage and best practice #bookmap

Dan Vint
 

Personally I like them in the toc when you really only want a heading. The draw back is they only exist in the toc so there is nothing to link to. You will see that the url does not change if you give it a try. But the toc will typically register expanding the content list nested within.

For me I see it keeping a writer from just generating random introductory text because you have no place to create content.

With that said, my company is on a seek and destroy mission to remove them. It didn't help our situation in a recent update where the toc didn't synch to the topic being displayed. That drew attention to this problem as well as having short introductory topics that said something to the effect of:

To do xxxx see the following topics.



Sent from my Verizon, Samsung Galaxy smartphone


-------- Original message --------
From: "Matt Lorenzi via groups.io" <mjlorenzi@...>
Date: 4/24/20 12:44 PM (GMT-08:00)
To: main@dita-users.groups.io
Subject: Re: [dita-users] Topichead usage and best practice #bookmap

I'm a little confused, why would they exist then if you can't possibly link to them - unless it's for a PDF output scenario only? So is it best to avoid topichead if potentially outputting the map in both PDF and HTML (and you want to link to this heading)?


Re: --args.output.base="%~ni"

Mark Giffin
 

Scott,

What happens when you try this? Any errors? It seems like it should work. One comment, there is a space in this parameter that might mess something up: --args.output.base=" %~ni"

Remove the space.

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

On 4/21/2020 8:06 AM, scott ashmead via groups.io wrote:
Hi All,

I'm using a DOS "for loop" to execute a DITA-OT command line.
The problem is that I need to change the output file name for each loop so that I don't overwrite the previous output file.

I'm trying to use --args.output.base="%~ni" but it has no effect. 
The output file is always named Global.xml because that's what the name of the ditamap is (Global.ditamap)

Is there another parameter I can/should use?

For more context, here's the complete command:

for %i in (c:\temp_test\*.xml) do (
dita -input C:\Global_Map\Global.ditamap -format resxml -output C:\curl_XML\ --args.filter="C:\ditaval\%~ni.ditaval" -DditaValFilePath="%~ni" --args.output.base=" %~ni")

Thank you,
Scott


Re: Topichead usage and best practice #bookmap

Matt Lorenzi
 

I'm a little confused, why would they exist then if you can't possibly link to them - unless it's for a PDF output scenario only? So is it best to avoid topichead if potentially outputting the map in both PDF and HTML (and you want to link to this heading)?


Re: Topichead usage and best practice #bookmap

Dan Vint
 

Topicheads in html output do not give you something you can link to, they are just organizational. You are probably having difficulties trying to define a key for them as they are not a topic or a map



Sent from my Verizon, Samsung Galaxy smartphone


-------- Original message --------
From: "Matt Lorenzi via groups.io" <mjlorenzi@...>
Date: 4/24/20 11:23 AM (GMT-08:00)
To: main@dita-users.groups.io
Subject: [dita-users] Topichead usage and best practice #bookmap

We have a set of common chapter-level topics that are just used for heading purposes, i.e.: Inspection, Installation, Certification, etc.

I learned just recently that you can use <topichead> in a ditamap instead of a stand-alone DITA topic to serve the same purpose.

This is nice to know since it seems a bit odd to use a topic with just a <title> element in it. I suspect this method was used (before my time), as this was the only way we knew how to create a chapter heading, and to ensure consistent chapter headings throughout all our DITA documentation. 

So, if using <topichead>, can it be used in conjunction with keys? I would still like to ensure common usage for chapter headings where appropriate, and if a <topichead> wound need to be created for each ditamap I can see inconsistencies creeping in. How would I use <topichead> with keys/key refs?


Topichead usage and best practice #bookmap

Matt Lorenzi
 

We have a set of common chapter-level topics that are just used for heading purposes, i.e.: Inspection, Installation, Certification, etc.

I learned just recently that you can use <topichead> in a ditamap instead of a stand-alone DITA topic to serve the same purpose.

This is nice to know since it seems a bit odd to use a topic with just a <title> element in it. I suspect this method was used (before my time), as this was the only way we knew how to create a chapter heading, and to ensure consistent chapter headings throughout all our DITA documentation. 

So, if using <topichead>, can it be used in conjunction with keys? I would still like to ensure common usage for chapter headings where appropriate, and if a <topichead> wound need to be created for each ditamap I can see inconsistencies creeping in. How would I use <topichead> with keys/key refs?


Re: Ant and using xmlcatalog with xslt or xmltask #XSLT

Eric Sirois
 

Hi Radu,

Thanks, will read through that one too

Eric

On Thursday, April 23, 2020, 11:54 PM, Radu Coravu <radu_coravu@...> wrote:

Hi Eric,

There was a similar discussion on the DITA OT issues list:

https://github.com/dita-ot/dita-ot/issues/3142

Regards,
Radu
Radu Coravu
Oxygen XML Editor
On 4/24/20 4:11 AM, Eric Sirois wrote:
Woohoo!  That resolves the issue.

<xmlcatalog id="ditaCatalog">
<catalogpath>
<fileset dir="${dita.dir}" includes="**/catalog.xml"/>
<fileset dir="${dita.dir}" includes="**/catalog-dita.xml"/>
</catalogpath>
</xmlcatalog>


On Thursday, April 23, 2020, 08:58:21 p.m. EDT, Eric Sirois <easirois@...> wrote:


Hi,

I want to run some processes in the depend.preprocess.pre stage of the OT.  So that means that the topics still have the doctypes in the documents.  The issue is that neither the <xmltask> nor the <xslt> process is able to properly find the catalog entry for the DTD (custom or OASIS). I am even trying to run things independently of the OT in oxygen, but just using the OT catalogs and it's still not working.

In oxygen I loaded the libraries saxon, xercesImpl xml-apis, xml-resolver, and ant-apache-resolver.  Am I missing some? Has anyone else been able to run an Ant task using the catalogs in a pre-process task. I have run things inside our publishing engine without issue, but it loads a ton of jars into memory but runs without any issues. I need it to run within an OT plugin.


  


Re: Ant and using xmlcatalog with xslt or xmltask #XSLT

Radu Coravu
 

Hi Eric,

There was a similar discussion on the DITA OT issues list:

https://github.com/dita-ot/dita-ot/issues/3142

Regards,
Radu
Radu Coravu
Oxygen XML Editor
On 4/24/20 4:11 AM, Eric Sirois wrote:

Woohoo!  That resolves the issue.

<xmlcatalog id="ditaCatalog">
<catalogpath>
<fileset dir="${dita.dir}" includes="**/catalog.xml"/>
<fileset dir="${dita.dir}" includes="**/catalog-dita.xml"/>
</catalogpath>
</xmlcatalog>


On Thursday, April 23, 2020, 08:58:21 p.m. EDT, Eric Sirois <easirois@...> wrote:


Hi,

I want to run some processes in the depend.preprocess.pre stage of the OT.  So that means that the topics still have the doctypes in the documents.  The issue is that neither the <xmltask> nor the <xslt> process is able to properly find the catalog entry for the DTD (custom or OASIS). I am even trying to run things independently of the OT in oxygen, but just using the OT catalogs and it's still not working.

In oxygen I loaded the libraries saxon, xercesImpl xml-apis, xml-resolver, and ant-apache-resolver.  Am I missing some? Has anyone else been able to run an Ant task using the catalogs in a pre-process task. I have run things inside our publishing engine without issue, but it loads a ton of jars into memory but runs without any issues. I need it to run within an OT plugin.


  


Re: Ant and using xmlcatalog with xslt or xmltask #XSLT

Eric Sirois
 

Woohoo!  That resolves the issue.

<xmlcatalog id="ditaCatalog">
<catalogpath>
<fileset dir="${dita.dir}" includes="**/catalog.xml"/>
<fileset dir="${dita.dir}" includes="**/catalog-dita.xml"/>
</catalogpath>
</xmlcatalog>


On Thursday, April 23, 2020, 08:58:21 p.m. EDT, Eric Sirois <easirois@...> wrote:


Hi,

I want to run some processes in the depend.preprocess.pre stage of the OT.  So that means that the topics still have the doctypes in the documents.  The issue is that neither the <xmltask> nor the <xslt> process is able to properly find the catalog entry for the DTD (custom or OASIS). I am even trying to run things independently of the OT in oxygen, but just using the OT catalogs and it's still not working.

In oxygen I loaded the libraries saxon, xercesImpl xml-apis, xml-resolver, and ant-apache-resolver.  Am I missing some? Has anyone else been able to run an Ant task using the catalogs in a pre-process task. I have run things inside our publishing engine without issue, but it loads a ton of jars into memory but runs without any issues. I need it to run within an OT plugin.