DITA and XMetaL Discussion
Derek Read February 27, 2013 at 12:45 am
Generating Kindle (MOBI) Output with XMetaL Author EnterpriseFebruary 27, 2013 at 12:45 amParticipants 1Replies 0Last Activity 9 years, 7 months ago
Products: XMetaL Author Enterprise versions 7.0 and 8.0
While generating output from your DITA documents using the deliverable named “Kindle (mobi format experimental)” you see an error similar to the following:
[quote=XMetaL Author Enterprise 7.0]Output could not be generated because the application 'kindle.exe' was not found. If this software is already installed ensure XMetaL is configured to locate it.
XMetaL is currently looking here:
[quote=XMetaL Author Enterprise 8.0]Output could not be generated because the application 'kindlegen.exe' was not found. Amazon.com, Inc. offers 'KindleGen' as a free download from their website amazon.com. If this software is already installed ensure XMetaL is configured to locate it. XMetaL is currently looking here: C:DOCUME~1
Note: On newer versions of Windows or on systems where the path to your %appdata% folder has been reconfigured by your IT staff the paths above may vary.
XMetaL Author Enterprise 7.0 and 8.0 both include the [url=http://sourceforge.net/projects/dita4publishers/]DITA 4 Publishers[/url] plug-in and it has been configured to generate most of the outputs that plug-in supports. To generate “Kindle” output the plug-in relies on a piece of software made freely available by Amazon.com, Inc called “KindleGen”. However, because Amazon does not allow redistribution of KindleGen you must install it separately.
1. Download the Windows version of KindleGen from the Amazon.com website: http://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
Note: You must agree to their licensing terms to obtain the download.
2. Extract the contents of the downloaded file (it should be a .zip file) to a temporary location.
3. From that temporary location, copy the file named “kindlegen.exe” to the following folder:
On 32-bit versions of Windows:
C:Program FilesCommon FilesXMetaL SharedDITA_OTpluginsnet.sourceforge.dita4publishers.kindlekindle_binkindlegen.exe
On 64-bit versions of Windows:
C:Program Files (x86)Common FilesXMetaL SharedDITA_OTpluginsnet.sourceforge.dita4publishers.kindlekindle_binkindlegen.exe
4. Redeploy the DITA Open toolkit so the “deployed” version (the one XMetaL uses to generate output) picks up the change:
4a. Launch XMetaL Author Enterprise.
4b. From the Tools menu select Configure Output…
4c. On the Advanced tab find the “Other output parameters” section and look for the parameter cmd_dita_ot_per_user_version.
4d. Increase the value by 1 (example: change 1 to 2) then dismiss the dialog by clicking OK.
The next time you generate output click the OK button when prompted to upgrade the DITA OT. The DITA OT will be redeployed together with the kindlegen.exe and you will now be able to generate output in Kindle / MOBI format.
To view Kindle / MOBI documents on the same machine you run XMetaL Author Enterprise on you will need software capable of displaying files with the .mobi file extension. Amazon.com, Inc offers the “Kindle Previewer” here: http://www.amazon.com/gp/feature.html/?ie=UTF8&docId=1000765261
Of course, you may also copy any files produced this way to a Kindle device to view them.
- You must be logged in to reply to this topic.