DITA and XMetaL Discussion

XMetaL Community Forum DITA and XMetaL Discussion Generating Kindle (MOBI) Output with XMetaL Author Enterprise

  • Derek Read

    Generating Kindle (MOBI) Output with XMetaL Author Enterprise

    Participants 1
    Replies 0
    Last Activity 9 years, 7 months ago

    Products: XMetaL Author Enterprise versions 7.0 and 8.0

    Issue:
    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:
    C:DOCUME~1APPLIC~1SoftQuadXMETAL~1DITA_OTpluginsnet.sourceforge.dita4publishers.kindlekindle_binkindlegen.exe

    [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~1APPLIC~1SoftQuadXMETAL~1DITA_OTpluginsnet.sourceforge.dita4publishers.kindlekindle_binkindlegen.exe

    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.

    Background:
    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.

    Solution:
    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.

    Optional:
    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.

    Reply

  • You must be logged in to reply to this topic.

Lost Your Password?

Products
Downloads
Support