RE: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10)
I am not sure ... I will go check the site to see which version it is and report back soon. Z -Original Message- From: framers-boun...@lists.frameusers.com [mailto:framers-boun...@lists.frameusers.com] On Behalf Of Robert Lauriston Sent: Friday, May 18, 2012 11:55 AM To: framers@lists.frameusers.com Subject: Re: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10) Are you using Confluence 3.x or 4.x? The work I've been doing is irrelevant to 3.x, which requires wiki markup. On Fri, May 18, 2012 at 11:44 AM, Syed Zaeem Hosain (syed.hos...@aeris.net) syed.hos...@aeris.net wrote: Thanks, Jeremy. I will take a look at his efforts to do this. I already have a login on mif2go.com and recently download the demo version of MIF2go 4.0. Just need to install and try it to see if it is what works best for me. If so, then I will proceed to a purchase. ___ You are currently subscribed to framers as syed.hos...@aeris.net. 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/syed.hosain%40aeris.net Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info. ___ 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: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10)
Okay, it looks like it is Confluence 4.X ... we use their hosted site for Jira by Atlassian (www.atlassian.com), so it is there latest hosted version of Confluence. Z -Original Message- From: Syed Zaeem Hosain (syed.hos...@aeris.net) Sent: Friday, May 18, 2012 11:44 PM To: 'Robert Lauriston'; framers@lists.frameusers.com Subject: RE: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10) I am not sure ... I will go check the site to see which version it is and report back soon. Z -Original Message- From: framers-boun...@lists.frameusers.com [mailto:framers-boun...@lists.frameusers.com] On Behalf Of Robert Lauriston Sent: Friday, May 18, 2012 11:55 AM To: framers@lists.frameusers.com Subject: Re: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10) Are you using Confluence 3.x or 4.x? The work I've been doing is irrelevant to 3.x, which requires wiki markup. On Fri, May 18, 2012 at 11:44 AM, Syed Zaeem Hosain (syed.hos...@aeris.net) syed.hos...@aeris.net wrote: Thanks, Jeremy. I will take a look at his efforts to do this. I already have a login on mif2go.com and recently download the demo version of MIF2go 4.0. Just need to install and try it to see if it is what works best for me. If so, then I will proceed to a purchase. ___ 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: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10)
On Fri, 18 May 2012 11:07:03 -0700, Syed Zaeem Hosain (syed.hos...@aeris.net) syed.hos...@aeris.net wrote: So, I need to change my flow to output clean HTML that can be far more easily put into Confluence and am trying to figure out the best way to proceed here. Do people have recommendations as to the best workflow for this? I have changed the title of this thread to make sure that I don't confuse everybody ... Mif2Go user Robert Lauriston is currently working on just that issue, and has found ways to produce pages *mostly* suitable for Confluence input. See his threads in the Forums under XHTML: http://mif2go.com/forums/mif2go/web/xhtml If you can't get to the link, create a free account for yourself on the home page: http://mif2go.com We require registration solely to prevent spammers from making the forums unusable, and approve them pretty quickly. When Robert is done, we'll probably bundle all his required settings into one, Confluence=Yes. -- Jeremy H. Griffith, at Omni Systems Inc. jer...@omsys.comhttp://mif2go.com/ ___ 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: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10)
Well .. *if* you switched to DITA, there are lots of options for getting very clean HTML (already discussed). If you stay with unstructured FM, you don't want to get the HTML directly from FM (as you've found) .. it can probably be fixed up a bit from what you're seeing, but that option is not optimal. You'll need to buy some addon or tool to get something useful. Mif2Go is an excellent choice .. or for more money you could use RoboHelp, Flare, or ePublisher .. others? This should maintain your hyperlinks and all will work well. I can't say how the confluence import will go, but most of these tools are configurable enough (especially Mif2Go and ePublisher) to make it work. This won't really change your workflow. You'd continue to do what you're doing, but in the end you'd use the chosen tool to export to HTML as well as your current PDF export path. As I said .. DITA will get you there too, but it'll be a lot of work, and you may not really benefit much from the effort. That is, unless you have a lot of shared content. DITA is all about reuse and modularity. If you've got a considerable amount of content that is used in multiple deliverables, it might just be worth the effort. Cheers, ...scott On 5/18/12 11:07 AM, Syed Zaeem Hosain wrote: Thanks, Nadine and Scott. As I mentioned in my other e-mail, DITA is just a learning curiosity for me at this point. It *seems* overly compex for what I need, but looking to learn nevertheless ... Now to real reason for this thread! My *current* flow is simple: 1. Write the documents and specifications in Unstructured FrameMaker 10. These typical range from 10 pages to 200 page FM books (typically as four separate chapters: Title, Content, Body and Index), and all have similar look and feel - given that I am the only author, I can control this easily (and anally! :)). The content has quite a few referenced hyperlinks to other content within them (only a few to external URL's) and these do come out properly in the PDF. Sidebar: my experience with text references (which I *would* like to use for common content) has been not good - due to *my* not wanting to waste time figuring out what *I* am doing wrong. My typical problem is that character formats applied to text within the referenced content does not show correctly in the final output, and I haven't bothered figuring out why - although I would like to someday keep the common text in other files (text or FM) really, so that a single change to them gets reflected in all the referencING documents. 2. Print to PDF using Adobe Acrobat X Pro. I have found that Save as PDF and Print to Adobe PDF usually results in differing output and have learned, over the years, to experiment with each new release of DM and Acrobat, and the settings, till I get what I need. With the latest versions of FM 10 and Acrobat Pro X, it looks like Print to Adobe PDF is best at the moment, although Save as PDF from within FrameMaker worked a lot better in the past. 3. Fix the few PDF file properties that did not come across from FrameMaker 10. This is usually stuff like Copyright information and meta-data that I just change manually - some can be set and forget in FrameMaker 10, but others need changes after the PDF is done. I have not found the place in FrameMaker to do some of these items ... ... deep breath moment ... However, I have a *new* need for the near future. There is a desire to have our documentation and specs, etc., as hyperlinked HTML pages - but, with the PDF as an available separate option still). I *do* like the idea of doing this actually, and now need to take my current FM books and specs and output them in the correct format (for Confluence ... see below). But, my early experiments with using the HTML output capability in FM 10 and Acrobat Pro X is *miserable* to say the least! The result is atrocious and unusable really. In the interim, one person has been taking my PDF documents (he does not know how to use FrameMaker) and creating all the HTML pages manually from the PDF text (argh!) and inserting them into Confluence (see http://www.atlassian.com/software/confluence/overview for more info on that). The result is a loss of the text hyperlinks, lots of time to do the work, etc., etc., etc. So, I need to change my flow to output clean HTML that can be far more easily put into Confluence and am trying to figure out the best way to proceed here. Do people have recommendations as to the best workflow for this? I have changed the title of this thread to make sure that I don't confuse everybody ... Thanks! Z ___ 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
RE: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10)
Thanks, Jeremy. I will take a look at his efforts to do this. I already have a login on mif2go.com and recently download the demo version of MIF2go 4.0. Just need to install and try it to see if it is what works best for me. If so, then I will proceed to a purchase. Thanks again! Z -Original Message- From: framers-boun...@lists.frameusers.com [mailto:framers-boun...@lists.frameusers.com] On Behalf Of Jeremy H. Griffith Sent: Friday, May 18, 2012 11:29 AM To: framers@lists.frameusers.com Subject: Re: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10) On Fri, 18 May 2012 11:07:03 -0700, Syed Zaeem Hosain (syed.hos...@aeris.net) syed.hos...@aeris.net wrote: So, I need to change my flow to output clean HTML that can be far more easily put into Confluence and am trying to figure out the best way to proceed here. Do people have recommendations as to the best workflow for this? I have changed the title of this thread to make sure that I don't confuse everybody ... Mif2Go user Robert Lauriston is currently working on just that issue, and has found ways to produce pages *mostly* suitable for Confluence input. See his threads in the Forums under XHTML: http://mif2go.com/forums/mif2go/web/xhtml If you can't get to the link, create a free account for yourself on the home page: http://mif2go.com We require registration solely to prevent spammers from making the forums unusable, and approve them pretty quickly. When Robert is done, we'll probably bundle all his required settings into one, Confluence=Yes. -- Jeremy H. Griffith, at Omni Systems Inc. jer...@omsys.comhttp://mif2go.com/ ___ You are currently subscribed to framers as syed.hos...@aeris.net. 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/syed.hosain%40aeris.net Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info. ___ 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: Would like to get comments from people about my flow changes (Was RE: Resources to help a newbie create DITA documents in FrameMaker 10)
Are you using Confluence 3.x or 4.x? The work I've been doing is irrelevant to 3.x, which requires wiki markup. On Fri, May 18, 2012 at 11:44 AM, Syed Zaeem Hosain (syed.hos...@aeris.net) syed.hos...@aeris.net wrote: Thanks, Jeremy. I will take a look at his efforts to do this. I already have a login on mif2go.com and recently download the demo version of MIF2go 4.0. Just need to install and try it to see if it is what works best for me. If so, then I will proceed to a purchase. ___ 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.
