- oXygen-user - www.oxygenxml.com

Drop-down list of recently used DITAVAL files?
by Richard Forster 21 Jan '15

21 Jan '15

Hello Oxygen Team Is there an easy way of accessing recently used DITAVAL files in the transformation scenario settings? It would be great if the Filters tab of the transformation scenario settings had e.g. a drop-downlist next to the "Use DITAVAL file" box that would allow me to select from the last 10 or 12 DITAVAL files that I had been using. Or something similar... Thanks for considering! Richard Richard Forster Information Architect Global Publication Support Services Varian Medical Systems Imaging Lab GmbH Täfernstrasse 7 CH-5405 Baden-Dättwil Switzerland Phone: ++41 (0) 56 203 0482 Mail: richard.forster(a)varian.com Web: www.varian.com<http://www.varian.com/> [cid:image001.jpg@01CA6FA7.B0905130]

2 1

Transformation Scenario to docx
by Sascha Manns 12 Jan '15

12 Jan '15

2 1

Oxygen 16.1 - Marklogic debugging scenarios
by Frank Mortier 07 Jan '15

07 Jan '15

Dear all: I acquired Friday Oxygen 16.1 in order to debug a Marklogic application. I have encountered the same problem as Jacob in http://www.oxygenxml.com/pipermail/oxygen-user/2013-June/004698.html. The ML application uses the xqmvc framework whereby the main file is index.xqy, but the routing is provided by another module xqmvc.xqy, importing controller files which import modules. See e.g.: http://www.marklogic.com/blog/founders-online-lesson-performance/ and https://code.google.com/p/xqmvc/ I have been unsuccessfully testing various debugging scenarios yesterday, amongst others including all xqy files. I was also not able to debug a module in the basic framework. Related: what is the difference between using a validation scenario or a transformation scenario. I notice a difference between the documentation and the demo at http://www.oxygenxml.com/demo/XQueryDebuggerforMarkLogic.html Any suggestions? Frank

2 4

View Final + Comments?
by Tony Graham 07 Jan '15

07 Jan '15

'Track Changes' is good, and being able to select 'View Final' is good, but there's times when I want to 'view final' but also be able to see comments. Is there an option that will let me 'view final' but also see the comments that are managed by the 'Track Changes' feature? Regards, Tony Graham. -- Senior Architect XML Division Antenna House, Inc. ---- Skerries, Ireland tgraham(a)antenna.co.jp

2 4

Keyboard Shortcut for Entity-List
by Sascha Manns 16 Dec '14

16 Dec '14

Hello List, does anyone know if a Shortcut exists for accessing the entities in Author-Mode without using the Mouse? Greetings Sascha -- Yours sincerly Sascha Manns

2 1

Re: [oXygen-user] Help with XPath -- SOLVED
by Mary Anthony 06 Dec '14

06 Dec '14

OK, I was able to solve this. My problem being that I forgot the varialbe_keywords.ditamap was not always *being processed* --- so it was an external file located in the temp output dir during processing. So, the solution is, set a path to the file:  <xsl:param name="PATH2PROJ"> <xsl:apply-templates select="/processing-instruction('path2project-uri')[1]" mode="get-path2project"/> </xsl:param> <xsl:param name="WORKDIR"> <xsl:apply-templates select="/processing-instruction('workdir-uri')[1]" mode="get-work-dir"/> </xsl:param> <xsl:variable name="VAR-FILE" select="concat($WORKDIR,$PATH2PROJ,'variable_keywords.ditamap')"/> Then use the doc() function to point to this external file: <xsl:comment> <xsl:value-of select="doc($VAR-FILE)/map/keydef[@keys='var_release_version']/topicmeta/keywords/keyword"/> </xsl:comment> If anyone knows a more elegant solution, feel free to post it back. Mary On Fri, Dec 5, 2014 at 8:12 AM, Mary Anthony <mary(a)platfora.com> wrote: > Hi, > > I am adding a comment to each file that contains a release number. The > release number is one of many variables defined in a > *variable_keywords.ditamap* file. This file is a child of my main > *ditamap*. > > Using the XPath Builder, I tested and found this path located the node I > needed. (Below is a pic showing the path succeeding.) When I encode this > path in the dita2webhelp.xsl file, the transformation succeeds but the > node's RELEASE_VERSION content is not output: > > <xsl:comment> > <xsl:value-of > select="/map/keydef[@keys='var_release_version']/topicmeta/keywords/keyword"/> > > </xsl:comment> > > What am I doing wrong? > > > > > PICTURE SHOWING THE PATH > [image: Inline image 1] >

2 1

Help with XPath
by Mary Anthony 05 Dec '14

05 Dec '14

Hi, I am adding a comment to each file that contains a release number. The release number is one of many variables defined in a *variable_keywords.ditamap* file. This file is a child of my main *ditamap*. Using the XPath Builder, I tested and found this path located the node I needed. (Below is a pic showing the path succeeding.) When I encode this path in the dita2webhelp.xsl file, the transformation succeeds but the node's RELEASE_VERSION content is not output: <xsl:comment> <xsl:value-of select="/map/keydef[@keys='var_release_version']/topicmeta/keywords/keyword"/> </xsl:comment> What am I doing wrong? PICTURE SHOWING THE PATH [image: Inline image 1]

1 0

automatically add a signature comment on new xquery and xslt files
by Erik Zander 03 Dec '14

03 Dec '14

Hi list I was wondering if any of you knew how to make oxygen generate a comment at the top of all new xquery and xslt files with my name and some other static text. If possible and additional benefit would be if also the current date was inserted . Best Regards Erik

2 1

warning if closing invalid documents
by Peter Stadler 03 Dec '14

03 Dec '14

Hi all, is there a way of prompting the user before closing an invalid file? I have some encoders who would really appreciate such a feature … Many thanks for any advice Peter -- Peter Stadler Carl-Maria-von-Weber-Gesamtausgabe Arbeitsstelle Detmold Gartenstr. 20 D-32756 Detmold Tel. +49 5231 975-665 Fax: +49 5231 975-668 stadler at weber-gesamtausgabe.de www.weber-gesamtausgabe.de

3 2

[Ann] New maintenance build available for oXygen 16.1 (2014112517)
by Oxygen XML Editor Support (Adrian Buza) 28 Nov '14

28 Nov '14

Dear oXygen users, We announce the release of a new maintenance build (2014112517) for oXygen 16.1 (XML Editor, XML Developer, XML Author). The build number can be verified in the Help -> About dialog box from the application (next to the version number). You can download the new installation kits from our web site: http://www.oxygenxml.com/download.html Here you can find the complete list of bug-fixes: http://www.oxygenxml.com/build_history.html#2014112517 You can follow our oXygen release/build RSS feed here: http://www.oxygenxml.com/rssBuildID.xml Please let us know if you encounter any problems with this new build. Regards, Adrian -- Adrian Buza oXygen XML Editor and Author Support Tel: +1-650-352-1250 ext.202 Fax: +40-251-461482 support(a)oxygenxml.com http://www.oxygenxml.com

1 0

Format & Indent multiple files?
by Roger Sheen 25 Nov '14

25 Nov '14

I know this has been requested before, so I’m curious to hear whether a future oXygen version might include the ability to Format & Indent multiple files at once--perhaps via a context menu item in Project View? Until then, I’m looking for a way to batch format & indent multiple files & limit line width to a maximum value. It seems `xmllint --format` doesn’t provide a line width option. The context menu in Project View suggests I could apply a transformation scenario to a folder. Could this be used to achieve the same result, perhaps through some use of the saxon:line-length and saxon:indent-spaces options? Or is there a command I could run on the command line that would approximate the results of oXygen’s Format & Indent feature? Regards, Roger

2 2

duplicate element
by Roderik Dernison 25 Nov '14

25 Nov '14

Hi, I've created my own extension of DITA. Amongst others I have added an element "predicate", like this: <xs:element name="predicate"> <xs:annotation> <xs:documentation>A <predicate> element marks the predicate, e.g. GROOT(Jan). (TP-ELEMENT)</xs:documentation> </xs:annotation> <xs:complexType> <xs:complexContent> <xs:extension base="predicate.class"> <xs:attribute ref="class" default="- ling-d/pred "/> </xs:extension> </xs:complexContent> </xs:complexType> </xs:element> <xs:complexType name="predicate.class" mixed="true"/> Now when I create a new ling topic, oXygen tells me E [Xerces] cos-nonambig: predicate and predicate (or elements from their substitution group) violate "Unique Particle Attribution". During validation against this schema, ambiguity would be created for those two particles. My lingGrp.xsd contains: <xs:group name="predicate"> <xs:sequence> <xs:choice> <xs:element ref="predicate" /> </xs:choice> </xs:sequence> </xs:group> My lingDomain.xsd contains: <xs:group name="ling-d-pred"> <xs:choice> <xs:group ref="predicate" /> </xs:choice> </xs:group> And my ling.xsd contains: <xs:group ref="ling-d-pred" /> No other references are made to predicate. What am I doing wrong? Kind regards, Ing. Roderik Dernison ________________________________ ---------------------------------------------------------- Aan dit bericht kunnen geen rechten worden ontleend. Het bericht is alleen bestemd voor de geadresseerde. Indien het bericht niet voor u is bestemd, verzoeken wij u dit aan ons te melden en het bericht te verwijderen. This message shall not constitute any obligations. This message is intended solely for the addressee. If you have received this message in error, please inform us and delete the message. ----------------------------------------------------------

2 1

Transforming without Entity placeholders
by Sascha Manns 19 Nov '14

19 Nov '14

Hello list, i have some XML files from a DocBook handbook project. The files are chunked into different chapter files. Now i would like to transform each chapter file that it outputs the same docbook code but with solved entity solution. So the result should be a clean DocBook file without entity placeholders. Has anyone done this already? Greetings Sascha -- Yours sincerly Sascha Manns

2 3

never mind on the ant build script question
by Tom Johnson 18 Nov '14

18 Nov '14

Never mind on the ant build script question. My temp folder didn't get deleted, so the script was only processing the files there. Tom --------------------- 801-822-2241 blog: idratherbewriting.com twitter: tomjohnson

2 1

Feature request - XML format preferences
by David Sewell 18 Nov '14

18 Nov '14

This is not very important, but if it would be easy to implement I think it is worth doing: In oXygen Preferences, under "Editor - Format - XML", in the section "Elements Spacing", the available options are "Add" and "Remove. Could "Edit" be added? David -- David Sewell, Editorial and Technical Manager ROTUNDA, The University of Virginia Press PO Box 400314, Charlottesville, VA 22904-4314 USA Email: dsewell(a)virginia.edu Tel: +1 434 924 9973 Web: http://rotunda.upress.virginia.edu/

2 1

ant build.xml script processes only 10 items at a time?
by Tom Johnson 17 Nov '14

17 Nov '14

I have a question about the build.xml script located inside this folder: [Oxygen install directory]/Applications/oxygenAuthor_161/frameworks/dita/DITA-OT/plugins/h2d. When I have an HTML file in this directory and I run "ant" from the Terminal, the build.xml script kicks off and converts the first 10 HTML files to DITA topics. I have many more HTML files that I want included in the auto-conversion (more than 1). How can I have the build.xml script convert *all* of the HTML files in that directory? Tom --------------------- 801-822-2241 blog: idratherbewriting.com twitter: tomjohnson

1 0

get an ID on a page?
by Tom Johnson 14 Nov '14

14 Nov '14

Is there any way to get an ID on a page using DITA and transforming with the DITA OT? For example, I want to add something like this: <p id="toc"/> Even if I hack the Oxygen source to allow IDs to pass through, as I described here ( http://idratherbewriting.com/wpdita/toc_publishing/jquery_side_panel/) the ID gets prepended with the topic ID. This makes it difficult to trigger the jQuery script, which has a trigger of #toc. Each page's p id will change based on the page's topic ID. I tried using a class with the jquery plugin instead, but it doesn't seem to work. This is the TOC plugin: http://fuelyourcoding.com/scripts/toc/index.html. Thanks, Tom --------------------- 801-822-2241 blog: idratherbewriting.com twitter: tomjohnson

2 3

find references to topic before deleting them?
by Roderik Dernison 13 Nov '14

13 Nov '14

Hi, How can I quickly find references to a topic (in a ditamap or topics contained in that ditamap), before I delete it or remove it from a ditamap? Vriendelijke groet, Ing. Roderik Dernison Programmeur/ontwikkelaar INL * Schatkamer van de Nederlandse Taal Matthias de Vrieshof 2 * Kamer 106a * 2311 BZ Leiden Tel. +31 (0)71 527 2491 * www.inl.nl<http://www.inl.nl/> ________________________________ ---------------------------------------------------------- Aan dit bericht kunnen geen rechten worden ontleend. Het bericht is alleen bestemd voor de geadresseerde. Indien het bericht niet voor u is bestemd, verzoeken wij u dit aan ons te melden en het bericht te verwijderen. This message shall not constitute any obligations. This message is intended solely for the addressee. If you have received this message in error, please inform us and delete the message. ----------------------------------------------------------

2 1

Oxygen Framework Builder
by Claudius Teodorescu 05 Nov '14

05 Nov '14

Hi, I developed an automatic builder for Oxygen frameworks which allows user to describe framework's behaviour by using only XQuery, HTML, and CSS, and automatically generate the framework archive ready to be deployed. A short tutorial can be found at [1]. I hope this plugin will be helpful. Claudius [1] http://kuberam.ro/oxygen-addon-builder/

1 0

IS_FEEDBACK_ENABLED
by Mary Anthony 04 Nov '14

04 Nov '14

Hi, I am using Oxygen 16.1 we use the Webhelp plugin to create help for our product and documentation on our public website. The look and feel of the help versus the public website is very different. In the help we use the standard search that comes with the plugin but on the website we will be using our website search. To transform our source using the Webhelp with Feedback. I'd like to use a <xsl:if> to test whether the generation is for Webhelp or Webhelp with feedback. The problem is I can't see to find a parameter to test against. I tried using IS_FEEDBACK_ENABLED but it depends on WEBHELP_PRODUCT_ID and that returns and error: *Variable WEBHELP_PRODUCT_ID has not been declared (or its declaration is not in scope)* Anyone know of a parameter or variable that will work as a test? (I could also use the editor variables if someone could give me an examples of accessing one from within an XSL stylesheet) Thanks, Mary

2 1

List of separate Oxygen plugin/framework projects
by Radu Coravu 04 Nov '14

04 Nov '14

Hi everybody, I'm trying to put together a list of separate projects which develop Oxygen plugins and frameworks: > http://blog.oxygenxml.com/2014/11/public-hosted-oxygen-plugin-and.html If anybody else knows projects which can be added to the list, please tell us. Regards, Radu Radu Coravu <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com

1 0

Re: [oXygen-user] integrate Oxygen output into build process?
by Sorin Ristache 29 Oct '14

29 Oct '14

Hello Tom, Please let us know if we can further help you. I am not particularly familiar with the Mercurial event hooks like post commit, but I suppose you would just plug into the post commit hook a shell script like the dita.sh attached to my previous message. I could find a list of the Mercurial hooks here: http://hgbook.red-bean.com/read/handling-repository-events-with-hooks.html http://hgbook.red-bean.com/read/handling-repository-events-with-hooks.html#… Best regards, Sorin <oXygen/> XML Editor http://www.oxygenxml.com Tom Johnson wrote: > Sorin, thanks, this is just the information I was looking for. Let me > process it and see if I can set something up. Ideally I want to just > fire everything off from the command line when I commit. > > Tom > > --------------------- > 801-822-2241 > blog: idratherbewriting.com <http://idratherbewriting.com> > twitter: tomjohnson > > On Tue, Oct 28, 2014 at 2:16 AM, Sorin Ristache <sorin(a)sync.ro > <mailto:sorin@sync.ro>> wrote: > > Hi Tom, > > In the Oxygen application a transformation can be started only > manually, for example with an action available on a toolbar or a > menu or with a custom Author mode extension action. A transformation > can be started automatically as in your case (registered as a hook > on a version control event) only outside the Oxygen application, as > an independent Java process or as a CLI shell command. > > For DITA files we provide only the WebHelp transformation as a > independent process (outside the Oxygen application). It is a > DITA-OT plugin which can be integrated in a DITA-OT > 1.6.x/1.7.x/1.8.x installation and which is available as a separate > product on the Oxygen website, which means it requires a separate > purchased license. The WebHelp pages created by this DITA-OT plugin > are the same as the ones created in the Oxygen application applied > to the same DITA files. I attach a README file with the DITA-OT > integration instructions and also a sample script for starting the > WebHelp transformation from a command line. If you need more details > please let me know. > > For other DITA transformations started outside the Oxygen > application I suggest running the built-in transformations which > come with the DITA-OT kit and which can generate PDF output, Windows > Help output, Eclipse Help output, etc. The DITA-OT documentation > includes instructions for starting a DITA transformation from a > command line: > > https://dita-ot.github.io/1.8/__readme/tranforming-dita-__content.html > <https://dita-ot.github.io/1.8/readme/tranforming-dita-content.html> > > > Best regards, > Sorin > > <oXygen/> XML Editor > http://www.oxygenxml.com > > > Mary Anthony wrote: > > Hi Tom, > > Most commercial companies would use a continuous integration > tool such as Bamboo, Hudson, or Buildbot to kick a build on > commit. I've used Bamboo myself to build such a system for > Javadoc and Webworks. Depends on your resources. > > A Mercurial post commit hook might be the way for you to go. I > quick google of "mercurial post commit hook build" gave me > several results. > Good luck, > > Mary > > On Mon, Oct 27, 2014 at 11:27 AM, Tom Johnson > <tomjohnson1492(a)gmail.com <mailto:tomjohnson1492@gmail.com> > <mailto:tomjohnson1492@gmail.__com > <mailto:tomjohnson1492@gmail.com>>> wrote: > > Does anyone know how to tell Oxygen to initiate > transformations when > I commit to a version control repository, specifically > Mercurial? > Just like Javadocs gets auto-kicked off when developers commit > source files, I'd like to do the same with Oxygen and my > DITA files. > > Tom > > > > INTRODUCTION > ============= > > This directory contains the Oxygen Webhelp plugin version > @@VERSION@@ for DITA Open Toolkit. The Webhelp output files are > exactly the same as for the DITA Webhelp transformations executed > inside the Oxygen XML Editor @@VERSION@@ application. The plugin > must be first integrated in the DITA Open Toolkit for adding the > following transformation types to the DITA Open Toolkit: > > webhelp - The Webhelp transformation for desktop output > > webhelp-feedback - The Webhelp transformation for desktop output > with a section for > user comments at the bottom of each XHTML output > page > > webhelp-mobile - The Webhelp transformation for mobile devices output > > > More details about all the Webhelp transformations are available on > the Oxygen website: > > http://www.oxygenxml.com/xml_editor/webhelp.html > > > LICENSE TERMS > ============== > > The license terms of the Oxygen Webhelp distribution are set forth > in the file EULA_Webhelp.txt located in the same directory as this > README file. > > > REQUIREMENTS > ============= > > The requirements of the Oxygen Webhelp plugin for DITA Open Toolkit > are the following: > > - Java Virtual Machine 1.6 or later > > - DITA Open Toolkit 1.6.x, 1.7.x or 1.8.x (the 'full easy install' > distribution) > > - Saxon 9.1.0.8 processor > > > INSTALL THE WEBHELP PLUGIN IN DITA-OT > ====================================== > > 1. Download and install a Java Virtual Machine 1.6 or later and a > DITA Open Toolkit 1.6.x, 1.7.x or 1.8.x (the 'full easy install' > distribution) if you don't have them already installed: > > http://www.oracle.com/technetwork/java/javase/downloads/index.html > > http://sourceforge.net/projects/dita-ot/files/DITA-OT%20Stable%20Release/ > > 2. Copy the parent directory of this README file, called > 'com.oxygenxml.webhelp', and the directory called > 'com.oxygenxml.highlight', in the 'plugins' subdirectory of the > install directory of the DITA Open Toolkit where you want to run the > Oxygen Webhelp transformation. > > 3. Run the following command in the directory of DITA Open Toolkit: > > ant -f integrator.xml > > The integrator.xml file is located in the DITA Open Toolkit install > directory. This will add two plugins to DITA-OT: Oxygen Webhelp > plugin (directory com.oxygenxml.webhelp) and Oxygen highlight plugin > (directory com.oxygenxml.highlight). > > 4. Download and unzip on your computer the saxonb9-1-0-8j.zip file > containing the Saxon 9.1.0.8 processor from: > > http://sourceforge.net/projects/saxon/files/Saxon-B/9.1.0.8/ > > > REGISTER YOUR OXYGEN LICENSE IN THE WEBHELP PLUGIN > =================================================== > > Create a text file called 'licensekey.txt' in the directory > [DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp. Copy and paste > in this file your Oxygen Scripting license key which you purchased > for your Oxygen Webhelp plugin. The Webhelp transformation will read > the Oxygen license key from this file. If this file does not exist > or it contains an invalid license key an error message will be > displayed. > > > RUN THE WEBHELP TRANSFORMATION in DITA-OT > ========================================== > > The following command will run the Webhelp transformation. This > command is available also as a script file in the same directory as > this README file, called dita.sh for Unix/Linux based system and > dita.bat for Windows systems. Just set the correct values of the > script variables at the beginning at the script file before calling > the script in an automated process or from a command line. > > > "[JVM-install-dir]/bin/java" -Xmx512m -classpath > "[DITA-OT-install-dir]/tools/ant/lib/ant-launcher.jar" > "-Dant.home=[DITA-OT-install-dir]/tools/ant" > org.apache.tools.ant.launch.Launcher -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/xercesImpl.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/xml-apis.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/xml-apis-ext.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/dost-patches.jar" > -lib "[DITA-OT-install-dir]" -lib "[DITA-OT-install-dir]/lib" -lib > "[Saxon-9.1.0.8-dir]/saxon9.jar" -lib > "[Saxon-9.1.0.8-dir]/saxon9-dom.jar" -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/license.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/log4j.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/resolver.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/ant-contrib-1.0b3.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/lucene-analyzers-common-4.0.0.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/lucene-core-4.0.0.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/xhtml-indexer.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.highlight/lib/xslthl-2.1.0.jar" > -lib > "[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib/webhelpXsltExtensions.jar" > -f "[DITA-OT-install-dir]/build.xml" > "-Dtranstype=[webhelp.transtype]" "-Dbasedir=[DITA-map-base-dir]" > "-Doutput.dir=[DITA-map-base-dir]/out/[webhelp.transtype]" > "-Ddita.temp.dir=[DITA-map-base-dir]/temp/[webhelp.transtype]" > "-Dargs.filter=[DITAVAL-dir]/[file.ditaval]" > "-Ddita.input.valfile=[DITAVAL-dir]/[file.ditaval]" > "-Dargs.hide.parent.link=no" "-Ddita.dir=[DITA-OT-install-dir]" > "-Dargs.xhtml.classattr=yes" > "-Dargs.input=[DITA-map-base-dir]/[input-DITA-map-file.ditamap]" > "-Dwebhelp.skin.css=[DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/predefined-skins/dita/oxygen/skin.css" > "-DbaseJVMArgLine=-Xmx384m" > > > where: > > - [JVM-install-dir] must be replaced with the path of the Java > Virtual Machine install directory > > - [DITA-OT-install-dir] must be replaced with the path of the DITA > Open Toolkit install directory > > - [Saxon-9.1.0.8-dir] must be replaced with the path of the > directory were the Saxon 9 archive file (saxonb9-1-0-8j.zip) was > unzipped > > - [webhelp.transtype] must be one of the values: webhelp, > webhelp-feedback, webhelp-mobile > > - [DITA-map-base-dir] must be replaced with the path of the > directory of the input DITA map file > > - [DITAVAL-dir] must be replaced with the path of the directory of > [file.ditaval] which sets the DITAVAL input filter > > - [file.ditaval] must be replaced with the name of the DITAVAL input > filter file that will be applied to the input map > > - [input-DITA-map-file.ditamap] must be replaced with the name of > the input DITA map file > > > The '-Dargs.filter' and '-Ddita.input.valfile' parameters are optional. > > The Webhelp output pages are generated in the directory that is set > in the parameter 'output.dir', by default > [DITA-map-base-dir]/out/[transtype]. > > The -Dwebhelp.skin.css parameter sets a skin CSS for the Webhelp > output pages. In the above example the predefined skin called > "Oxygen" was set. A set of predefined skins come with the Webhelp > kit in the directory predefined-skins. For building your own custom > skin please use the Webhelp Skin Builder from: > > http://www.oxygenxml.com/webhelp-skin-builder/ > > A company logo image can be optionally added to the main title in > the header area of the Webhelp output pages with the parameter: > -Dwebhelp.logo.image. A URL can be optionally set for the logo image > to point to using the parameter: -Dwebhelp.logo.image.target.url. > > > CONFIGURE DATABASE (ONLY FOR WEBHELP WITH FEEDBACK TRANSFORMATIONS) > ==================================================================== > > For the transformations that generate Webhelp pages allowing user > comments (webhelp-feedback) the database with the user comments must > be configured. This is done by opening the following file in a Web > browser and following the installation instructions from this file: > > [DITA-map-base-dir]/out/[transtype]/oxygen-webhelp/resources/installation.html > > > OTHER PARAMETERS OF WEBHELP TRANSFORMATION > =========================================== > > The Webhelp parameters that can be appended to the command line that > runs the Webhelp transformation: > > -Dwebhelp.copyright (text string value) - The copyright note that > will be added in the footer of the Table of Contents frame (the left > side frame of the WebHelp output). > > -Dwebhelp.footer.include (possible values: 'yes', 'no') - If set > to 'no' no footer is added to the Webhelp pages. If set to 'yes' and > the webhelp.footer.file parameter has a value, then the content of > that file is used as footer in each Webhelp output page. If > webhelp.footer.file has no value then the default Oxygen footer is > inserted in each Webhelp page. > > -Dwebhelp.footer.file (file path of XHTML file) - Specifies the > location of a well-formed XHTML file containing your custom footer > for the document body. Corresponds to XSLT parameter > WEBHELP_FOOTER_FILE. The fragment must be well-formed XHTML, with a > single root element. Common practice is to place all content into a > <div>. > > -Dwebhelp.product.id <http://Dwebhelp.product.id> (text string > value, required for the transformations with user feedback) - A > short name for the documentation target (product). All user comments > that will be posted in the Webhelp output pages and will be added in > the comments database on the server will be bound to this product > ID. Examples: 'mobile-phone-user-guide', 'hvac-installation-guide', > etc. Documentation for multiple products can be deployed on the same > server. > > -Dwebhelp.product.version (text string value, required for the > transformations with user feedback) - The documentation version > number, for example: 1.0, 2.5, etc. New user comments are bound to > this version. Multiple documentation versions can be deployed on the > same server. > > > Other DITA-OT parameters that are needed for a customization of the > Webhelp transformation can be appended to the above command line > following the model of the -D parameters like > 'args.hide.parent.link' and 'args.xhtml.classattr'. For example the > 'args.hdr' parameter can be appended in the form: > > "-Dargs.hdr=/path/to/directory/of/header-file.html" > > where [dir-of-header-file] will be replaced with the path of the > directory containing the header file.

1 0

How to transfer Oxygen from an old computer to a new one?
by Jean-Luc Chevillard 28 Oct '14

28 Oct '14

Dear list members, I have just discovered the existence of this list this morning and it is just possible that the question I am having has been asked one hundred times, in which case I apologize in advance. What is the correct procedure for transferring Oxygen from one computer to another one. Do I have to uninstall from the old computer and reinstall on the new? (as is the case for instance for Adobe Creative Suite). What happens if the old computer has become so unstable that it is difficult to access? I am having all the Oxygen licence numbers safely stored on some external hard disk. Thanks for any pointer. -- Jean-Luc Chevillard (CNRS, Paris)

2 1

integrate Oxygen output into build process?
by Tom Johnson 28 Oct '14

28 Oct '14

Does anyone know how to tell Oxygen to initiate transformations when I commit to a version control repository, specifically Mercurial? Just like Javadocs gets auto-kicked off when developers commit source files, I'd like to do the same with Oxygen and my DITA files. Tom --------------------- 801-822-2241 blog: idratherbewriting.com twitter: tomjohnson

3 2

Transforming scenario wiki
by Sascha Manns 24 Oct '14

24 Oct '14

Hello list, actually i'm trying to use a transforming scenario for docbook. It should use Docbook 4.4, 4.5 or 5 and export it to a wiki syntax. Ideally it should transform into the XWiki-Syntax (http://platform.xwiki.org/xwiki/bin/view/Main/XWikiSyntax) but if anyone already has done this with a similar syntax i can try to fix the rest of the syntax by myself. Has anyone tried it out? -- Yours sincerly Sascha Manns

2 1