Re: Eclipse Help from Frame books
Hi Alastair: I'm currently using Mif2Go to convert my FrameMaker books to Eclipse User Assistance. I've been using it for about 10 years now. I tried out WebWorks ePublisher about 5 years ago, and I found it wasn't quite as flexible as Mif2Go when it came to organizing the Eclipse UA XML files for tables of contents, but it might have improved by now. If you want more information about developing documentation for Eclipse UA, you can join this discussion group: http://groups.yahoo.com/group/eclipse_tw/messages/101 Fei Min Lorente -Original Message- Message: 3 Date: Thu, 4 Jul 2013 16:41:52 -0400 From: Art Campbell art.campb...@gmail.com To: Alastair Dent alastair.d...@imgtec.com Cc: framers@lists.frameusers.com framers@lists.frameusers.com Subject: Re: Eclipse Help from Frame books Message-ID: CAOW=E1frUobUV+U=6uiwO=fgjh-ww7fhwkgpdu63hqb04sw...@mail.gmail.com Content-Type: text/plain; charset=ISO-8859-1 Jeremy is correct -- MIF2GO is pretty much the easiest and least painful way to do this. Once everything is set up for the Eclipse project, it's automatic / one-click. Art Art Campbell art.campb...@gmail.com ... In my opinion, there's nothing in this world beats a '52 Vincent and a redheaded girl. -- Richard Thompson No disclaimers apply. DoD 358 I support www.TheGrotonLine.com, hyperlocal news for Groton MA. On Mon, Jul 1, 2013 at 9:37 AM, Alastair Dent alastair.d...@imgtec.com wrote: Has anyone tried generating Eclipse help directly from Frame books? Alastair Dent Technical Author Imagination Technologies Limited t: +44 (0)113 242 9814 www.imgtec.com ___ You are currently subscribed to framers as art.campb...@gmail.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/art.campbell%40gma il.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info. -- Message: 4 Date: Thu, 4 Jul 2013 12:37:06 -0700 From: Robert Lauriston rob...@lauriston.com To: framers@lists.frameusers.com Subject: Re: Eclipse Help from Frame books Message-ID: can3yy4ahjmsu0ugygeywb-kll5m+myfox_davuwqexkj0ja...@mail.gmail.com Content-Type: text/plain; charset=ISO-8859-1 MIF2Go worked for me a few years ago. WebWorks ePublisher can also now generate Eclipse Help from FrameMaker source. On Mon, Jul 1, 2013 at 6:37 AM, Alastair Dent alastair.d...@imgtec.com wrote: Has anyone tried generating Eclipse help directly from Frame books? ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
FM11 image weirdness
Hi group I’m using FM 11.0.2.384, Fm8.0p277 and DITA-FMx 1.1.16 01dec12 on Windows 7 Professional. My DITA topics contain images of various file formats: EPS, PNG, JPG.When I generate a FrameMaker book from my ditamap, I see the following in the generated Fm files: - In Fm 8: everything OK, all graphics are displayed - In Fm11: all graphics have no preview (I just see gray boxes) and they all appear in a very small anchored frame. The graphics are there (so, not missing) because when I double-click them in Fm they open just fine in Snagit. I only see this in Fm files which have been generated from a ditamap. When I open the DITA topics in Fm 11, the graphics are displayed OK. I have tested this with files which worked perfectly well on 4 July and I haven't done a Fm11 update since then (I think). Is anyone else seeing this? Thanks -- Yves Barbion www.scripto.nu ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Group for Frame users developing docs for Defense Dept. Agencies?
Is there a group for those of us who write for US military customers/audiences? If so, please direct me to it; if not, are others interested in forming one? Val ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Re: FM11 image weirdness SOLVED!
Hi group It turned out to be two weird JPG files which corrupted the whole bookbuild process. Kudos to Scott Prentice who pointed me in the right direction and thus prevented another sleepness night. Cheers! -- Yves Barbion www.scripto.nu ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
DITA/docbook vs your own schema
Does anyone know of a nice, clear list of what you save by using DITA/docbook instead of developing your own schema? The content maps reasonably well to DITA, but not perfectly. I'm trying to figure out whether we're better off working within the limitations of DITA, or whether we should take the DIY approach. A clear list of what you save by using DITA would be really helpful. Many thanks! Rebecca NOTICE: This message contains privileged and confidential information intended only for the use of the addressee named above. If you are not the intended recipient of this message you are hereby notified that you must not disseminate, copy or take any action in reliance on it. If you have received this message in error please notify Allied Telesis Labs Ltd immediately. Any views expressed in this message are those of the individual sender, except where the sender has the authority to issue and specifically states them to be the views of Allied Telesis Labs. ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Re: DITA/docbook vs your own schema
And unless you're very clever, it's easy to paint yourself into a corner with an in-house system. It might be simple to develop something for what your needs are now, but you neglect to make it open-ended or scalable for whatever changes you need to make in the future. And then there's portability... Nadine From: Alan Houser a...@groupwellesley.com To: framers@lists.frameusers.com framers@lists.frameusers.com Sent: Monday, July 8, 2013 6:50:36 PM Subject: Re: DITA/docbook vs your own schema I gotta generally agree with Matt. Occasionally I run into an information modeling project that I can knock off in an afternoon, but that's pretty rare. Remember that you will not only need to model block content (topics, headings, paragraphs, lists, etc.), but also tables, cross-references, images, etc. The latter set can be a bit tricky. Plus, oh, your metadata. With DITA or DocBook, you also get a publishing framework. Also usually non-trivial to create from scratch, especially if you are publishing to multiple output formats, using filtering, content re-use, etc. I'll mention with some regret that FrameMaker's DocBook support is pretty poor. I've never figured out why...the typical use cases for both (books, PDF) line up very well. It may be a chicken-and-egg issue...I suspect more people would use DocBook if FrameMaker provided better DocBook support. -Alan On 7/8/13 6:31 PM, Matt Sullivan wrote: A list of what you'll save using DITA or DocBook rather than creating your own schema: 1. Time 2. Money (Hey, someone had to say it…) -Matt ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Eclipse Help from Frame books
Hi Alastair: I'm currently using Mif2Go to convert my FrameMaker books to Eclipse User Assistance. I've been using it for about 10 years now. I tried out WebWorks ePublisher about 5 years ago, and I found it wasn't quite as flexible as Mif2Go when it came to organizing the Eclipse UA XML files for tables of contents, but it might have improved by now. If you want more information about developing documentation for Eclipse UA, you can join this discussion group: http://groups.yahoo.com/group/eclipse_tw/messages/101 Fei Min Lorente -Original Message- Message: 3 Date: Thu, 4 Jul 2013 16:41:52 -0400 From: Art CampbellTo: Alastair Dent Cc: "framers at lists.frameusers.com" Subject: Re: Eclipse Help from Frame books Message-ID:
FM11 image weirdness
Hi group I?m using FM 11.0.2.384, Fm8.0p277 and DITA-FMx 1.1.16 01dec12 on Windows 7 Professional. My DITA topics contain images of various file formats: EPS, PNG, JPG.When I generate a FrameMaker book from my ditamap, I see the following in the generated Fm files: - In Fm 8: everything OK, all graphics are displayed - In Fm11: all graphics have no preview (I just see gray boxes) and they all appear in a very small anchored frame. The graphics are there (so, not "missing") because when I double-click them in Fm they open just fine in Snagit. I only see this in Fm files which have been generated from a ditamap. When I open the DITA topics in Fm 11, the graphics are displayed OK. I have tested this with files which worked perfectly well on 4 July and I haven't done a Fm11 update since then (I think). Is anyone else seeing this? Thanks -- Yves Barbion www.scripto.nu -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/4bd8ace5/attachment.html>
Group for Frame users developing docs for Defense Dept. Agencies?
Is there a group for those of us who write for US military customers/audiences? If so, please direct me to it; if not, are others interested in forming one? Val
FM11 image weirdness SOLVED!
Hi group It turned out to be two weird JPG files which corrupted the whole bookbuild process. Kudos to Scott Prentice who pointed me in the right direction and thus prevented another sleepness night. Cheers! -- Yves Barbion www.scripto.nu -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/f998fccc/attachment.html>
DITA/docbook vs your own schema
Does anyone know of a nice, clear list of what you save by using DITA/docbook instead of developing your own schema? The content maps reasonably well to DITA, but not perfectly. I'm trying to figure out whether we're better off working within the limitations of DITA, or whether we should take the DIY approach. A clear list of what you save by using DITA would be really helpful. Many thanks! Rebecca NOTICE: This message contains privileged and confidential information intended only for the use of the addressee named above. If you are not the intended recipient of this message you are hereby notified that you must not disseminate, copy or take any action in reliance on it. If you have received this message in error please notify Allied Telesis Labs Ltd immediately. Any views expressed in this message are those of the individual sender, except where the sender has the authority to issue and specifically states them to be the views of Allied Telesis Labs. -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/1e57fcf0/attachment.html>
DITA/docbook vs your own schema
A list of what you'll save using DITA or DocBook rather than creating your own schema: Time Money (Hey, someone had to say it?) -Matt On Jul 8, 2013, at 12:06 AM, "rebecca officer" wrote: > Does anyone know of a nice, clear list of what you save by using DITA/docbook > instead of developing your own schema? > > The content maps reasonably well to DITA, but not perfectly. I'm trying to > figure out whether we're better off working within the limitations of DITA, > or whether we should take the DIY approach. A clear list of what you save by > using DITA would be really helpful. > > Many thanks! > Rebecca > > NOTICE: This message contains privileged and confidential > information intended only for the use of the addressee > named above. If you are not the intended recipient of > this message you are hereby notified that you must not > disseminate, copy or take any action in reliance on it. > If you have received this message in error please > notify Allied Telesis Labs Ltd immediately. > Any views expressed in this message are those of the > individual sender, except where the sender has the > authority to issue and specifically states them to > be the views of Allied Telesis Labs. > > > ___ > > > You are currently subscribed to framers as matt at mattrsullivan.com. > > Send list messages to framers at lists.frameusers.com. > > To unsubscribe send a blank email to > framers-unsubscribe at lists.frameusers.com > or visit > http://lists.frameusers.com/mailman/options/framers/matt%40mattrsullivan.com > > Send administrative questions to listadmin at frameusers.com. Visit > http://www.frameusers.com/ for more resources and info. -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/84d19b5d/attachment.html>
DITA/docbook vs your own schema
An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/4a18d2c9/attachment.html>
DITA/docbook vs your own schema
Yes, specialization should be approached delicately. One thing to keep in mind: DITA is (in my opinion) nearly as much philosophy as it is content model. Expect to spend some time understanding what the component pieces are, how they're labeled, and get used to looking at things from a topic point of view, rather than a chapter point of view. -Matt Matt R. Sullivan co-author Publishing Fundamentals: Unstructured FrameMaker 11 P: 714.798.7596 | C: 714.585.2335 | matt at mattrsullivan.com @mattrsullivan LinkedIn facebook mattrsullivan.com On Jul 8, 2013, at 3:41 PM, Kristy Nolan wrote: > I will add frustration to that list. We have modified a version of DocBook > called FlightBook. The modification of the modification leads to many issues > in getting the pieces to work together. By sticking with the standard, there > should not be as many issues. > > Kristy > -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/1ff9198c/attachment.html> -- next part -- A non-text attachment was scrubbed... Name: twitter.png Type: image/png Size: 1331 bytes Desc: not available URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/1ff9198c/attachment.png> -- next part -- A non-text attachment was scrubbed... Name: linkedin.png Type: image/png Size: 1380 bytes Desc: not available URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/1ff9198c/attachment-0001.png> -- next part -- A non-text attachment was scrubbed... Name: facebook.png Type: image/png Size: 1576 bytes Desc: not available URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/1ff9198c/attachment-0002.png> -- next part -- A non-text attachment was scrubbed... Name: blog.png Type: image/png Size: 1222 bytes Desc: not available URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/1ff9198c/attachment-0003.png>
DITA/docbook vs your own schema
I gotta generally agree with Matt. Occasionally I run into an information modeling project that I can knock off in an afternoon, but that's pretty rare. Remember that you will not only need to model "block" content (topics, headings, paragraphs, lists, etc.), but also tables, cross-references, images, etc. The latter set can be a bit tricky. Plus, oh, your metadata. With DITA or DocBook, you also get a publishing framework. Also usually non-trivial to create from scratch, especially if you are publishing to multiple output formats, using filtering, content re-use, etc. I'll mention with some regret that FrameMaker's DocBook support is pretty poor. I've never figured out why...the "typical" use cases for both (books, PDF) line up very well. It may be a chicken-and-egg issue...I suspect more people would use DocBook if FrameMaker provided better DocBook support. -Alan On 7/8/13 6:31 PM, Matt Sullivan wrote: > A list of what you'll save using DITA or DocBook rather than creating > your own schema: > > 1. Time > 2. Money > > > (Hey, someone had to say it...) > > > -Matt > > -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/c92ae9eb/attachment.html>
DITA/docbook vs your own schema
All good info. More reasons to use DITA or DocBook is the availability of off-the-shelf authoring, publishing, and file management (CMS) tools. Also, personnel support (authoring and development) .. it is much easier to find people to work on one of the "standards" than your custom model. Cheers, ...scott On 7/8/13 3:50 PM, Alan Houser wrote: > I gotta generally agree with Matt. Occasionally I run into an > information modeling project that I can knock off in an afternoon, but > that's pretty rare. Remember that you will not only need to model > "block" content (topics, headings, paragraphs, lists, etc.), but also > tables, cross-references, images, etc. The latter set can be a bit > tricky. Plus, oh, your metadata. > > With DITA or DocBook, you also get a publishing framework. Also > usually non-trivial to create from scratch, especially if you are > publishing to multiple output formats, using filtering, content > re-use, etc. > > I'll mention with some regret that FrameMaker's DocBook support is > pretty poor. I've never figured out why...the "typical" use cases for > both (books, PDF) line up very well. It may be a chicken-and-egg > issue...I suspect more people would use DocBook if FrameMaker provided > better DocBook support. > > -Alan > > On 7/8/13 6:31 PM, Matt Sullivan wrote: >> A list of what you'll save using DITA or DocBook rather than creating >> your own schema: >> >> 1. Time >> 2. Money >> >> >> (Hey, someone had to say it...) >> >> >> -Matt >> >> > -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/acd4802f/attachment.html>
DITA/docbook vs your own schema
And unless you're very clever, it's easy to paint yourself into a corner with an in-house system.?It might be "simple" to develop something for what your needs are now, but you neglect to make it open-ended or scalable for whatever changes you need to make in the future. And then there's portability... Nadine > > From: Alan Houser >To: "framers at lists.frameusers.com" >Sent: Monday, July 8, 2013 6:50:36 PM >Subject: Re: DITA/docbook vs your own schema > > > >I gotta generally agree with Matt. Occasionally I run into an information >modeling project that I can knock off in an afternoon, but that's pretty rare. >Remember that you will not only need to model "block" content (topics, >headings, paragraphs, lists, etc.), but also tables, cross-references, images, >etc. The latter set can be a bit tricky. Plus, oh, your metadata. > >With DITA or DocBook, you also get a publishing framework. Also ??usually non-trivial to create from scratch, especially if you are ??publishing to multiple output formats, using filtering, content ??re-use, etc. > >I'll mention with some regret that FrameMaker's DocBook support is ??pretty poor. I've never figured out why...the "typical" use cases ??for both (books, PDF) line up very well. It may be a ??chicken-and-egg issue...I suspect more people would use DocBook if ??FrameMaker provided better DocBook support. > >-Alan > >On 7/8/13 6:31 PM, Matt Sullivan wrote: > >A list of what you'll save using DITA or DocBook rather than creating your own >schema: >>1. Time >>2. Money >> >> >>(Hey, someone had to say it?) >> >>-Matt
DITA/docbook vs your own schema
This article by Bernard Aschwanden on subsetting DITA may help: http://www.stc-siliconvalley.org/newsletter/2006_05/articles/aschwanden-subsetting-dita.htm On Mon, Jul 8, 2013 at 3:06 AM, rebecca officer < rebecca.officer at alliedtelesis.co.nz> wrote: > Does anyone know of a nice, clear list of what you save by using > DITA/docbook instead of developing your own schema? > > The content maps reasonably well to DITA, but not perfectly. I'm trying to > figure out whether we're better off working within the limitations of DITA, > or whether we should take the DIY approach. A clear list of what you save > by using DITA would be really helpful. > > Many thanks! > Rebecca > > > NOTICE: This message contains privileged and confidential > information intended only for the use of the addressee > named above. If you are not the intended recipient of > this message you are hereby notified that you must not > disseminate, copy or take any action in reliance on it. > If you have received this message in error please > notify Allied Telesis Labs Ltd immediately. > Any views expressed in this message are those of the > individual sender, except where the sender has the > authority to issue and specifically states them to > be the views of Allied Telesis Labs. > > > > ___ > > > You are currently subscribed to framers as john.sgammato at actifio.com. > > Send list messages to framers at lists.frameusers.com. > > To unsubscribe send a blank email to > framers-unsubscribe at lists.frameusers.com > or visit > http://lists.frameusers.com/mailman/options/framers/john.sgammato%40actifio.com > > Send administrative questions to listadmin at frameusers.com. Visit > http://www.frameusers.com/ for more resources and info. > > -- *John Sgammato * Documentation Architect *e* john.sgammato at actifio.com *w* +1-(508) 927-2083 *Recover anything instantly for up to 90% less than you're paying now.* -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/6dfc250a/attachment.html>
DITA/docbook vs your own schema
Okay, I'll start from the assumption that DITA or Docbook as standards are the way to go if you don't want to spend all kinds of time and money on development. Of course changing to DITA or Docbook will cost time and money, too. Just less of both. So which: DITA or Docbook DITA is much more restrictive. The topics are formed from a very finite set of elements which your crew can learn to use adroitly with a little study and practice. Docbook has everything plus the kitchen sink thrown in as elements because it is meant to do, well, just about everything. For my money DITA makes a lot more sense, but your writers have to understand the conceptual framework and work within that relative simplicity. Don't imagine that you can do things like four levels of nested lists. Docbook, by contrast, let's you do just about anything you've been doing in unstructured FrameMaker, you just have to learn which of the many many elements lets you go ahead and do that. For my money, DITA is the way to go . Craig From: framers-boun...@lists.frameusers.com [mailto:framers-bounces at lists.frameusers.com] On Behalf Of rebecca officer Sent: Monday, July 08, 2013 2:06 AM To: framers at lists.frameusers.com Subject: DITA/docbook vs your own schema Does anyone know of a nice, clear list of what you save by using DITA/docbook instead of developing your own schema? The content maps reasonably well to DITA, but not perfectly. I'm trying to figure out whether we're better off working within the limitations of DITA, or whether we should take the DIY approach. A clear list of what you save by using DITA would be really helpful. Many thanks! Rebecca NOTICE: This message contains privileged and confidential information intended only for the use of the addressee named above. If you are not the intended recipient of this message you are hereby notified that you must not disseminate, copy or take any action in reliance on it. If you have received this message in error please notify Allied Telesis Labs Ltd immediately. Any views expressed in this message are those of the individual sender, except where the sender has the authority to issue and specifically states them to be the views of Allied Telesis Labs. -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20130708/9d6cd8d4/attachment.html>