Skip to main content
Known Participant
July 14, 2016
Answered

Arabic, Chinese and Russian text import

  • July 14, 2016
  • 2 replies
  • 1197 views

Can anyone help me out with this one please? I'm exporting data from a database to a .txt file using MML. It works fine, except for the Arabic, Chinese and Russian language text, which isn't supported in a .txt file. If I save the file as Unicode, then the Arabic, Chinese and Russian language text is maintained, but then when I try to import that to FrameMaker, it doesn't see the Unicode file as MML, and so won't import it.

Has anyone else come across a similar problem, and maybe found a clever way around it please?

    This topic has been closed for replies.
    Correct answer Arnis Gubins

    Like all tools, there's a bit of a learning curve. However the user guide does have quite a number of samples that show you how things are done.

    There are two routes that you can take to process your data; use either a pure XML approach with XSLT to wrap your tags with the appropriate Miramo commands or use their macro pre-processor (mmpp) language (sort of like VBscript) to use your own tag structure to wrap the commands.

    The workflow is typically such that one uses the database reporing tool to create the preliminary tagged output (much the same as you're doing now for creating MML text files). Then you use either XSLT or mmpp (though you have to write your own code for these) to process the output to wrap the actual Miramo commands around the content. Then you run Miramo on this wrapped content. Miramo uses your specified FM templates to get the formatting info and produces MIF as output that feeds back into FM to create the final book (and also creates all required generated FM files like the TOC and Index). Miramo also lets you call in scripts (Framescript or Extendscript) or other special APIs to process the FM content at specified steps in the book creation workflow.

    Miramo is an enterprise-level tool that is designed for producing huge volumes of content. The Personal Edition is just limited in the number of concurrent output channels that be processed and requires a user to initiate each session rather than having sit on a server and automatically process content as it appears in specified locations.

    The latest version also let's you directly process DITA content (using FM templates, you get more cosmetic and easier control over the output than you could using the DITA-OT) and also has a new module that produces PDF directly without even going through FM.

    2 replies

    Arnis Gubins
    Inspiring
    July 14, 2016

    You could look consider a workflow modification to skip the MML export from the database and instead use Datazone's Miramo Personal Edition (see:  http://miramo.com/english/overview/dp_download.html​ ). This tool let's you use tagged output (either XML or your own tagging format) that you can then wrap in Miramo XML-syntax commands that get translated into FM layouts (template based using your FM-defined catalog tags). It's a very powerful tool that I've used for database publishing since the last century.

    It handles all languages and was able to get FM to process RTL languages before this latest version of FM.

    By the way, the Personal Edition is a freebie, but is limited to a non-server environment, i.e. you have to drive it manually and you can only run one instance at a time. For production, I can typically produce a couple of hundred page catalog or directory in a few minutes using this route.

    ppa_chrisAuthor
    Known Participant
    July 14, 2016

    Thanks Arnis - I'll have to look into that then. Seems MML is a total no-go as it has to be .txt format only, and that won't support the multi-bit non-western languages.

    Is the Miramo route fairly straight-forward to work with?

    Arnis Gubins
    Arnis GubinsCorrect answer
    Inspiring
    July 14, 2016

    Like all tools, there's a bit of a learning curve. However the user guide does have quite a number of samples that show you how things are done.

    There are two routes that you can take to process your data; use either a pure XML approach with XSLT to wrap your tags with the appropriate Miramo commands or use their macro pre-processor (mmpp) language (sort of like VBscript) to use your own tag structure to wrap the commands.

    The workflow is typically such that one uses the database reporing tool to create the preliminary tagged output (much the same as you're doing now for creating MML text files). Then you use either XSLT or mmpp (though you have to write your own code for these) to process the output to wrap the actual Miramo commands around the content. Then you run Miramo on this wrapped content. Miramo uses your specified FM templates to get the formatting info and produces MIF as output that feeds back into FM to create the final book (and also creates all required generated FM files like the TOC and Index). Miramo also lets you call in scripts (Framescript or Extendscript) or other special APIs to process the FM content at specified steps in the book creation workflow.

    Miramo is an enterprise-level tool that is designed for producing huge volumes of content. The Personal Edition is just limited in the number of concurrent output channels that be processed and requires a user to initiate each session rather than having sit on a server and automatically process content as it appears in specified locations.

    The latest version also let's you directly process DITA content (using FM templates, you get more cosmetic and easier control over the output than you could using the DITA-OT) and also has a new module that produces PDF directly without even going through FM.

    Jeff_Coatsworth
    Community Expert
    Community Expert
    July 14, 2016

    ?What version of FM? I seem to recall only the latest one supports RTL languages...

    ppa_chrisAuthor
    Known Participant
    July 14, 2016

    It's FrameMaker 13 - so the language support is there in FrameMaker and that isn't a problem - it's including it in an MML file that seems to be impossible.

    Jeff_Coatsworth
    Community Expert
    Community Expert
    July 14, 2016

    Having never worked with MML, I can't help you too much, but a quick google seems to indicate that MML only comes in ASCII text format. Maybe use a Unicode XML file or HTML source?