Re: migrating from FrameMaker to a wiki

2013-03-24 Thread Shmuel Wolfson
It doesn't sound like a very complicated import. If can supply a list of 
URLs for the target wiki pages, you could probably have someone write 
you an import utility for free by posting your request on this forum:

http://www.donationcoder.com/forum/index.php?board=71.0

The Coding Snacks page is where you can request small programs. If you 
like it, you can make a donation to the author.


The other option is to write something yourself using the AutoIt 
(www.autoitscript.com/site/autoit/). It's easy to learn.


Regards,
Shmuel Wolfson
Technical Writer
052-763-7133


On 22-Mar-13 8:03 PM, Robert Lauriston wrote:

Around a year ago I spent 4-5 months evaluating wikis with the goal of
migrating from FrameMaker. Confluence 4 and MindTouch were by far the
most practical, since they're based on XHTML rather than wiki markup.

One big challenge was converting thousands of pages of legacy docs. I
got MIF2Go working on a page-by-page basis for both. I got stuck
because I couldn't find a documented bulk import utility that worked.

Confluence has a very active user community and great support, but I
(and others) reached a dead end as far as bulk conversion from
FrameMaker:

https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4?page=1#27775

WebWorks ePublisher can convert from FrameMaker to Confluence, but
that's wiki markup and obsolete. If they ever update that to the new
XHTML format that could solve the problem.

If you're on a tight budget, forget about MindTouch, you get a choice
between a hosted solution (MindTouch TCS) that's fairly expensive and
a free version (MindTouch Core) that doesn't have enough support.


On Fri, Mar 22, 2013 at 10:28 AM, Syed Zaeem Hosain
(syed.hos...@aeris.net) syed.hos...@aeris.net wrote:

Anyway, as of yesterday, I am now exploring making all my work be hyperlinked 
Wiki documents instead

___


You are currently subscribed to framers as shmue...@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/shmuelw1%40gmail.com

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: migrating from FrameMaker to a wiki

2013-03-24 Thread Robert Lauriston
Confluence 4's import path is supposed to be MS Word, but there are
several bugs that make it unusable: cross-references are broken,
numbers are converted to plain text instead of ordered lists, and each
node of the TOC is sorted alphabetically.

I think Atlassian is in a catch-22 as regards the tech docs market:
they don't fix those bugs or support bulk import because not enough of
their users are voting for those bugs or enhancements, and not enough
users vote for those because it's too hard to migrate legacy content,
so tech docs departments are not using Confluence.

WebWorks can export a whole FrameMaker book to Confluence, breaking it
up into pages the same way it does for online help. It works fine with
Confluence 4 for read-only purposes but it doesn't create the XHTML
source you'd want for migrating permanently.
___


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: migrating from FrameMaker to a wiki

2013-03-24 Thread Robert Lauriston
If it were that simple, someone would have done it already. The
hundreds or thousands of target URLs need to be defined during import
based on topic names and used when converting the internal
cross-references.

https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4

https://bobswift.atlassian.net/wiki/display/CSOAP/Confluence+Command+Line+Interface?focusedCommentId=13107291#comment-13107291

On Sun, Mar 24, 2013 at 3:37 AM, Shmuel Wolfson shmue...@gmail.com wrote:
 It doesn't sound like a very complicated import. If can supply a list of
 URLs for the target wiki pages, you could probably have someone write you an
 import utility for free by posting your request on this forum:
 http://www.donationcoder.com/forum/index.php?board=71.0

 The Coding Snacks page is where you can request small programs. If you like
 it, you can make a donation to the author.

 The other option is to write something yourself using the AutoIt
 (www.autoitscript.com/site/autoit/). It's easy to learn.
___


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.


migrating from FrameMaker to a wiki

2013-03-24 Thread Shmuel Wolfson
It doesn't sound like a very complicated import. If can supply a list of 
URLs for the target wiki pages, you could probably have someone write 
you an import utility for free by posting your request on this forum:
http://www.donationcoder.com/forum/index.php?board=71.0

The Coding Snacks page is where you can request small programs. If you 
like it, you can make a donation to the author.

The other option is to write something yourself using the AutoIt 
(www.autoitscript.com/site/autoit/). It's easy to learn.

Regards,
Shmuel Wolfson
Technical Writer
052-763-7133


On 22-Mar-13 8:03 PM, Robert Lauriston wrote:
> Around a year ago I spent 4-5 months evaluating wikis with the goal of
> migrating from FrameMaker. Confluence 4 and MindTouch were by far the
> most practical, since they're based on XHTML rather than wiki markup.
>
> One big challenge was converting thousands of pages of legacy docs. I
> got MIF2Go working on a page-by-page basis for both. I got stuck
> because I couldn't find a documented bulk import utility that worked.
>
> Confluence has a very active user community and great support, but I
> (and others) reached a dead end as far as bulk conversion from
> FrameMaker:
>
> https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4?page=1#27775
>
> WebWorks ePublisher can convert from FrameMaker to Confluence, but
> that's wiki markup and obsolete. If they ever update that to the new
> XHTML format that could solve the problem.
>
> If you're on a tight budget, forget about MindTouch, you get a choice
> between a hosted solution (MindTouch TCS) that's fairly expensive and
> a free version (MindTouch Core) that doesn't have enough support.
>
>
> On Fri, Mar 22, 2013 at 10:28 AM, Syed Zaeem Hosain
> (Syed.Hosain at aeris.net)  wrote:
>> Anyway, as of yesterday, I am now exploring making all my work be 
>> hyperlinked Wiki documents instead
> ___
>
>
> You are currently subscribed to framers as shmuelw1 at gmail.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/shmuelw1%40gmail.com
>
> Send administrative questions to listadmin at frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.
>



migrating from FrameMaker to a wiki

2013-03-24 Thread Robert Lauriston
If it were that simple, someone would have done it already. The
hundreds or thousands of target URLs need to be defined during import
based on topic names and used when converting the internal
cross-references.

https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4

https://bobswift.atlassian.net/wiki/display/CSOAP/Confluence+Command+Line+Interface?focusedCommentId=13107291#comment-13107291

On Sun, Mar 24, 2013 at 3:37 AM, Shmuel Wolfson  wrote:
> It doesn't sound like a very complicated import. If can supply a list of
> URLs for the target wiki pages, you could probably have someone write you an
> import utility for free by posting your request on this forum:
> http://www.donationcoder.com/forum/index.php?board=71.0
>
> The Coding Snacks page is where you can request small programs. If you like
> it, you can make a donation to the author.
>
> The other option is to write something yourself using the AutoIt
> (www.autoitscript.com/site/autoit/). It's easy to learn.


Re: migrating from FrameMaker to a wiki

2013-03-23 Thread Jeremy H. Griffith
On Fri, 22 Mar 2013 11:03:46 -0700, Robert Lauriston rob...@lauriston.com 
wrote:

[snipped for brevity]

One big challenge was converting thousands of pages of legacy docs. I
got MIF2Go working on a page-by-page basis for both. I got stuck
because I couldn't find a documented bulk import utility that worked.

Yes; we still find it amazing that after creating a brand-new
internal format, they could not provide a way to import docs
that used it other than one at a time.  They've had over a 
year to do it.

WebWorks ePublisher can convert from FrameMaker to Confluence, but
that's wiki markup and obsolete. If they ever update that to the new
XHTML format that could solve the problem.

How?  That would just move them up to the same place Mif2Go is
at already; all correctly formatted, but no bulk import.  This
needs work at tha Atlassian end.

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


migrating from FrameMaker to a wiki

2013-03-23 Thread Jeremy H. Griffith
On Fri, 22 Mar 2013 11:03:46 -0700, Robert Lauriston  
wrote:

[snipped for brevity]

>One big challenge was converting thousands of pages of legacy docs. I
>got MIF2Go working on a page-by-page basis for both. I got stuck
>because I couldn't find a documented bulk import utility that worked.

Yes; we still find it amazing that after creating a brand-new
internal format, they could not provide a way to import docs
that used it other than one at a time.  They've had over a 
year to do it.

>WebWorks ePublisher can convert from FrameMaker to Confluence, but
>that's wiki markup and obsolete. If they ever update that to the new
>XHTML format that could solve the problem.

How?  That would just move them up to the same place Mif2Go is
at already; all correctly formatted, but no bulk import.  This
needs work at tha Atlassian end.

-- Jeremy H. Griffith, at Omni Systems Inc.
  http://mif2go.com/


migrating from FrameMaker to a wiki

2013-03-23 Thread Robert Lauriston
Confluence 4's import path is supposed to be MS Word, but there are
several bugs that make it unusable: cross-references are broken,
numbers are converted to plain text instead of ordered lists, and each
node of the TOC is sorted alphabetically.

I think Atlassian is in a catch-22 as regards the tech docs market:
they don't fix those bugs or support bulk import because not enough of
their users are voting for those bugs or enhancements, and not enough
users vote for those because it's too hard to migrate legacy content,
so tech docs departments are not using Confluence.

WebWorks can export a whole FrameMaker book to Confluence, breaking it
up into pages the same way it does for online help. It works fine with
Confluence 4 for read-only purposes but it doesn't create the XHTML
source you'd want for migrating permanently.


migrating from FrameMaker to a wiki

2013-03-22 Thread Robert Lauriston
Around a year ago I spent 4-5 months evaluating wikis with the goal of
migrating from FrameMaker. Confluence 4 and MindTouch were by far the
most practical, since they're based on XHTML rather than wiki markup.

One big challenge was converting thousands of pages of legacy docs. I
got MIF2Go working on a page-by-page basis for both. I got stuck
because I couldn't find a documented bulk import utility that worked.

Confluence has a very active user community and great support, but I
(and others) reached a dead end as far as bulk conversion from
FrameMaker:

https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4?page=1#27775

WebWorks ePublisher can convert from FrameMaker to Confluence, but
that's wiki markup and obsolete. If they ever update that to the new
XHTML format that could solve the problem.

If you're on a tight budget, forget about MindTouch, you get a choice
between a hosted solution (MindTouch TCS) that's fairly expensive and
a free version (MindTouch Core) that doesn't have enough support.


On Fri, Mar 22, 2013 at 10:28 AM, Syed Zaeem Hosain
(syed.hos...@aeris.net) syed.hos...@aeris.net wrote:
 Anyway, as of yesterday, I am now exploring making all my work be hyperlinked 
 Wiki documents instead
___


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: migrating from FrameMaker to a wiki

2013-03-22 Thread Syed Zaeem Hosain (syed.hos...@aeris.net)
Thanks, Robert!

We also use Confluence as a managed service - so it is probably the latest 
version, but I will check. That would be the place where we would put our Wiki 
version of documentation.

Yes, I do have a bunch of legacy documents too - many, many pages , so maybe 
Mif2Go may be a necessary purchase for me as well. Bulk conversion is probably 
not critical, but certainly new versions could be done that way as I work on 
them.

Regards,

Z

-Original Message-
From: robert.lauris...@gmail.com [mailto:robert.lauris...@gmail.com] On Behalf 
Of Robert Lauriston
Sent: Friday, March 22, 2013 11:04 AM
To: Syed Zaeem Hosain (syed.hos...@aeris.net); framers@lists.frameusers.com
Subject: migrating from FrameMaker to a wiki

Around a year ago I spent 4-5 months evaluating wikis with the goal of 
migrating from FrameMaker. Confluence 4 and MindTouch were by far the most 
practical, since they're based on XHTML rather than wiki markup.

One big challenge was converting thousands of pages of legacy docs. I got 
MIF2Go working on a page-by-page basis for both. I got stuck because I couldn't 
find a documented bulk import utility that worked.

Confluence has a very active user community and great support, but I (and 
others) reached a dead end as far as bulk conversion from
FrameMaker:

https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4?page=1#27775

WebWorks ePublisher can convert from FrameMaker to Confluence, but that's wiki 
markup and obsolete. If they ever update that to the new XHTML format that 
could solve the problem.

If you're on a tight budget, forget about MindTouch, you get a choice between a 
hosted solution (MindTouch TCS) that's fairly expensive and a free version 
(MindTouch Core) that doesn't have enough support.


On Fri, Mar 22, 2013 at 10:28 AM, Syed Zaeem Hosain
(syed.hos...@aeris.net) syed.hos...@aeris.net wrote:
 Anyway, as of yesterday, I am now exploring making all my work be 
 hyperlinked Wiki documents instead

___


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.


migrating from FrameMaker to a wiki

2013-03-22 Thread Robert Lauriston
Around a year ago I spent 4-5 months evaluating wikis with the goal of
migrating from FrameMaker. Confluence 4 and MindTouch were by far the
most practical, since they're based on XHTML rather than wiki markup.

One big challenge was converting thousands of pages of legacy docs. I
got MIF2Go working on a page-by-page basis for both. I got stuck
because I couldn't find a documented bulk import utility that worked.

Confluence has a very active user community and great support, but I
(and others) reached a dead end as far as bulk conversion from
FrameMaker:

https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4?page=1#27775

WebWorks ePublisher can convert from FrameMaker to Confluence, but
that's wiki markup and obsolete. If they ever update that to the new
XHTML format that could solve the problem.

If you're on a tight budget, forget about MindTouch, you get a choice
between a hosted solution (MindTouch TCS) that's fairly expensive and
a free version (MindTouch Core) that doesn't have enough support.


On Fri, Mar 22, 2013 at 10:28 AM, Syed Zaeem Hosain
(Syed.Hosain at aeris.net)  wrote:
> Anyway, as of yesterday, I am now exploring making all my work be hyperlinked 
> Wiki documents instead


migrating from FrameMaker to a wiki

2013-03-22 Thread Syed Zaeem Hosain (syed.hos...@aeris.net)
Thanks, Robert!

We also use Confluence as a managed service - so it is probably the latest 
version, but I will check. That would be the place where we would put our Wiki 
version of documentation.

Yes, I do have a bunch of legacy documents too - many, many pages , so maybe 
Mif2Go may be a necessary purchase for me as well. Bulk conversion is probably 
not critical, but certainly new versions could be done that way as I work on 
them.

Regards,

Z

-Original Message-
From: robert.lauriston at gmail.com [mailto:robert.lauris...@gmail.com] On 
Behalf Of Robert Lauriston
Sent: Friday, March 22, 2013 11:04 AM
To: Syed Zaeem Hosain (Syed.Hosain at aeris.net); framers at 
lists.frameusers.com
Subject: migrating from FrameMaker to a wiki

Around a year ago I spent 4-5 months evaluating wikis with the goal of 
migrating from FrameMaker. Confluence 4 and MindTouch were by far the most 
practical, since they're based on XHTML rather than wiki markup.

One big challenge was converting thousands of pages of legacy docs. I got 
MIF2Go working on a page-by-page basis for both. I got stuck because I couldn't 
find a documented bulk import utility that worked.

Confluence has a very active user community and great support, but I (and 
others) reached a dead end as far as bulk conversion from
FrameMaker:

https://answers.atlassian.com/questions/19789/converting-from-framemaker-to-confluence-4?page=1#27775

WebWorks ePublisher can convert from FrameMaker to Confluence, but that's wiki 
markup and obsolete. If they ever update that to the new XHTML format that 
could solve the problem.

If you're on a tight budget, forget about MindTouch, you get a choice between a 
hosted solution (MindTouch TCS) that's fairly expensive and a free version 
(MindTouch Core) that doesn't have enough support.


On Fri, Mar 22, 2013 at 10:28 AM, Syed Zaeem Hosain
(Syed.Hosain at aeris.net)  wrote:
> Anyway, as of yesterday, I am now exploring making all my work be 
> hyperlinked Wiki documents instead