300 likes | 310 Views
Conference Number: 805-309-0248 Participant Code: 880-0006. Power Hour January 2013 ePublisher Invoking Tools and Post-Processing Outputs. Power Hour – January 2013. Agenda Next Month’s Topic ePublisher Invoking Tools and Post-Processing Outputs Survey Results Webinar Schedule.
E N D
Conference Number: 805-309-0248Participant Code: 880-0006 Power HourJanuary 2013 ePublisherInvoking Tools and Post-Processing Outputs
Power Hour – January 2013 Agenda • Next Month’s Topic • ePublisherInvoking Tools and Post-Processing Outputs • Survey Results • Webinar Schedule
Power Hour – January 2013 Next Month’s Topic
Next Month’s Topic Tie vote • PDFs from DITAExamining the process of DITA to XSL-FO to PDF • XSLT, Part IIBeyond the Basics, Applying to ePublisher
Power Hour – January 2013 ePublisherInvoking Tools and Post-Processing Outputs
Invoking Tools and Post-Processing Outputs What are your goals for this session?
Invoking Tools and Post-Processing Outputs What are your goals for this session? • Not familiar with external tools available to post-process generated files. • We use a few scripts with customized CSS files. Each time I upgrade the projects, I have to go into the Designer and be sure that the same selections are made.Is there an easier way to do this?
Invoking Tools and Post-Processing Outputs Topics to cover • Output files from an XML source • Post-process generated files with an external tool • Run scripts to include data in generated content • Run scripts during the publishing process to integrate with other systems
Invoking Tools and Post-Processing Outputs Background Topics • Using XSL to process XML and text files • Invoking command-line tools from XSL • Embedding scripts in XSL • Adding format stages • Finding files in files.info
Invoking Tools and Post-Processing Outputs Resources • Document XSL Extensionhttp://wiki.webworks.com/DevCenter/Documentation/ExtensionObjects/ePublisher/ExslDocument • Exec XSL Extensionhttp://wiki.webworks.com/DevCenter/Documentation/ExtensionObjects/ePublisher/Exec • MSXSL Script Blockshttp://msdn.microsoft.com/en-us/library/533texsx%28v=vs.80%29.aspx • Format Definition Fileshttp://www.webworks.com/Documentation/Reverb/#page/04.Reference%2520Information/How%2520It%2520Works.1.15.htm • Toys Transform Server + files.infohttp://toys.webworks.com/files-info-reporter (Resources for this webinar)
Invoking Tools and Post-Processing Outputs Using XSL to process XML and text files • Load files using standard document() function or ePublisher’s Load function <xsl:variable name="VarDocument1" select="document('file:///C:/info.xml')" /><xsl:variable name="VarDocument2" select="wwexsldoc:LoadXMLWithoutResolver ('file:///C:/info.xml')" /><xsl:variable name="VarDocument3" select="wwexsldoc:LoadXMLWithoutResolver ('C:\info.xml')" />
Invoking Tools and Post-Processing Outputs Using XSL to process XML and text files • Write files using ePublisher Document method <xsl:variable name="VarWriteDocument" select="wwexsldoc:Document( $VarResult, 'C:\badplacefor.xml')" />
Invoking Tools and Post-Processing Outputs Using XSL to process XML and text files • Replace strings in a fileFormats\Microsoft HTML Help 1.x\Transforms\htmlhelp_hhp.xsl <xsl:variable name="VarEntriesAsXML"> <wwmultisere:Entry match="$DefaultTopic;" replacement="{$VarDefaultTopic}" /> <wwmultisere:Entry match="$HomePage;" replacement="{$VarHomePage}" /></xsl:variable><xsl:variable name="VarEntries" select="msxsl:node-set($VarEntriesAsXML)/*" /><xsl:variable name="VarReplaceInFile" select="wwmultisere:ReplaceAllInFile( 'UTF-8', $GlobalHHPPageTemplatePath, 'UTF-8', $ParamOutPath, $VarEntries)" />
Invoking Tools and Post-Processing Outputs Using XSL to process XML and text files • Read text files into an XML documentShared\common\pages\pagetemplate.xsl • Use in combination with String Utilities http://wiki.webworks.com/DevCenter/Documentation/ExtensionObjects/ePublisher/StringUtilities <xsl:variable name="VarFileContents" select="wwstring:FromFile('C:\data.txt', 'UTF-8')" />
Invoking Tools and Post-Processing Outputs Invoking command-line tools from XSL • Invoke • Results <xsl:variable name="VarExecResult" select="wwexec:Execute('doit.exe in out')" /> <wwexec:Result version="1.0" retcode="-1"> <wwexec:Stream name="Output"> Standard output will show up here, aka stdout. </wwexec:Stream> <wwexec:Stream name="Error"> Standard error will show up here, aka stderr. </wwexec:Stream></wwexec:Result>
Invoking Tools and Post-Processing Outputs Embedding scripts in XSL • Examples in ePublisher (these use C#) • Shared\common\behaviors\finalize.xsl • Shared\common\index\combine.xsl • Shared\common\pdf\generate.xsl • WebWorks Reverb\Transforms\search-index.xsl • Any .NET language is supported(C#, VB.NET, F#, Jscript, etc.)
Invoking Tools and Post-Processing Outputs Adding format stages <Format version="1.0" xmlns="urn:WebWorks-Engine-Format-Schema"> <Capabilities>...</Capabilities> <TaskGroups>...</TaskGroups> <Pipelines> ... </Pipelines></Format>
Invoking Tools and Post-Processing Outputs Adding format stages <Pipelines> <Pipeline name="Alpha"> <Stage>...</Stage> </Pipeline> <Pipeline name="Omega"> <Depends pipeline="Alpha" /> <Stage>...</Stage> </Pipeline><Pipelines>
Invoking Tools and Post-Processing Outputs Adding format stages <Pipeline name="Omega"> <Depends pipeline="Alpha" /> <Stage type="xsl" action="wwformat:Transforms/pages.xsl"> <Parameter name="ParameterDependsType" value="engine:wif" /> <Parameter name="ParameterType" value="page:output" /> </Stage></Pipeline>
Invoking Tools and Post-Processing Outputs Finding files in files.info <File path="C:\Output\html\files\about-documents.html" displayname="" type="page:output" checksum="634952537864096566:6033" projectchecksum="Z3b3W8H104A" groupID="RkxF9LT9R3I" documentID="MeMtvSYl88c" pipeline="Page" actionchecksum="aNeO1hn2XvbWLGFTe/Fm+A==" category="pages" use="external" deploy="true">
Power Hour – January 2013 Survey Results
Survey Results When to meet:
Survey Results Voice Options:
Survey Results Topics to cover:
Survey Results Show Me! Topics to cover: • Working with ePublisher Designer - the basics and a bit beyond • Working with page breaks, TOCs, mini-TOCs and bookmarks when generating PDF documents from Word format. Show Me!
Power Hour – January 2013 Webinar Schedule
Webinar Schedule Power Hour: • February 28th at 2:00pm Central • Webinar Vote • PDFs from DITAExamining the process of DITA to XSL-FO to PDF • XSLT, Part IIBeyond the Basics, Applying to ePublisher Sign-up atwww.webworks.com/eSchool/Power_Hour/
Webinar Schedule Show Me: • February 21th at 1:30pm Central • Learn what the ePublisher platform can do for you • Repeats monthly on the 3rd Thursday Sign-up atwww.webworks.com/eSchool/Show_Me/
Webinar Schedule Study Hall: • February 13th at 1:00pm Central • Open forum for ePublisher users • Repeats monthly on the 2nd and last Wednesdays Join atwww.webworks.com/eSchool/Study_Hall/
Power HourJanuary 2013 ePublisherInvoking Tools and Post-Processing Outputs