Re: An interesting Mif2Go project - will this work?

2013-08-10 Thread John Sgammato 
It's been a big project, but we were successful!
Here's the skinny:
I need to import unstructured FM content into a new SalesForce Knowledge
knowledge base. Individual procedures written in FM11 get published out via
Mif2Go as Standard HTML (not help), and then imported by SalesForce with
the help of a .CSV file. Overall it required about a 30-step procedure to
get the content into SF, but now I plan to trim down the process. Then I
will write it up and present it at the STC Summit or some other place.
The first question is: Why is this so difficult? I think it's because it is
a technically challenging project that demands a lot of up-front work on
the FM side, so no knowledgebase provider wants to develop and support it,
and Adobe doesn't see the value in it for the neglected FrameMaker product
(and market!)

The trick is to produce what SalesForce needs from what FM can give it.
SalesForce's importer is pretty primitive and inflexible. AFAIK this is not
unusual; last year I tried the same thing with a MindTouch knowledge base
and that could import only from a .CHM, and even that was plagued with
problems.
SalesForce needs a set of HTML pages saved in a particular nested file
structure, accompanied by a .CSV file that provides the title of each
article, its address, and some other information. The HTML, folders, and
CSV must all be provided in a .ZIP along with a Project file created by the
SalesForce admin.

FM's Save as HTML is buggy, barely supported by Adobe, and its HTML is not
very clean. I could not generate good individual HTML pages from RoboHelp.
Mif2Go offers the flexibility I needed.
To develop the CSV was a different adventure. I needed a list of article
titles mapped to the HTML file names, which are autogenerated with names
like aa100543.htm. I could open each file and copy the title (there is a
Mif2Go setting to make the title match the FM Heading 1 or Heading 2), but
that would be tedious and error-prone for hundreds of files.

Jeremy had a workaround to get my titles and file names together. After
generating the Standard HTML output, I generated OmniHelp output just to
get a single .JS page with the list I needed. I deleted all the rest of the
output, keeping only that file.
Then I edited the file with several search-and-replaces and saved it as
.CSV.

Then I was able to zip together the HTML and the .CSV and hand it off to
the SalesForce Admin, who (after a few false starts) finally reproducibly
imported 24 and then 56 files. We have some bugs, but we think we know how
to fix them.

Now I have to refine the process, learn how to optimize my FM content, and
document it because once the knowledgebase is launched with my existing FM
content, I am committed to updating it forever!

Thanks everyone for all your input on this complex project!
john



On Sun, Aug 4, 2013 at 5:24 PM, John Sgammato john.sgamm...@actifio.comwrote:

 Thank you for all the guidance! I hope to get to it tonight

 On Sunday, August 4, 2013, Jeremy H. Griffith wrote:

 On Sun, 4 Aug 2013 16:20:31 -0400, John Sgammato 
 john.sgamm...@actifio.com wrote:

 I have no [OmniHelpOptions] at all.
 I renamed the HTML version, changing nothing but the name.
 That failed, so I tried editing Config= to point to he OmniHelp file -
 see below.
 I know something's not right, but I don't understand this path well
 enough to figure it out.

 The path looks fine.  I gather you aren't using the
 Documents template for HTML either?  That's OK,
 as long as the two projects are the same with that.
 The rest of your settings look OK.  Oh, add:

 [HelpContentsLevels]
 Title=1
 Heading1=1
 Heading2=1

 If you make them all level 1, your first replace
 will always be of [1,, no wildcard needed.

 See par. 7.4.3, Including contents entries in
 HTML-based Help.

 Perhaps I should have been more explicit about
 what to do in the Choose project dialog.  Select
 the HTML project, but don't push any buttons yet.

 Change the name in the top field, and for the
 second field push [...] and choose the new
 Omnihelp output directory,  Then select Omnihelp
 in the last field.

 NOW, press Add, then OK.  It should go on to the
 Export dialog, just continue as usual.

 -- Jeremy H. Griffith, at Omni Systems Inc.
   jer...@omsys.comhttp://mif2go.com/
 ___


 You are currently subscribed to framers as john.sgamm...@actifio.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/john.sgammato%40actifio.com

 Send administrative questions to listad...@frameusers.com. Visit
 http://www.frameusers.com/ for more resources and info.



 --









 *John Sgammato  *

 Documentation Architect

 *e* john.sgamm...@actifio.com

 *w* +1-(508) 927-2083

 *Recover anything instantly for up to 90% less than you're paying now.
 *




-- 









*John Sgammato  *

An interesting Mif2Go project - will this work?

2013-08-09 Thread John Sgammato 
It's been a big project, but we were successful!
Here's the skinny:
I need to import unstructured FM content into a new SalesForce Knowledge
knowledge base. Individual procedures written in FM11 get published out via
Mif2Go as Standard HTML (not help), and then imported by SalesForce with
the help of a .CSV file. Overall it required about a 30-step procedure to
get the content into SF, but now I plan to trim down the process. Then I
will write it up and present it at the STC Summit or some other place.
The first question is: Why is this so difficult? I think it's because it is
a technically challenging project that demands a lot of up-front work on
the FM side, so no knowledgebase provider wants to develop and support it,
and Adobe doesn't see the value in it for the neglected FrameMaker product
(and market!)

The trick is to produce what SalesForce needs from what FM can give it.
SalesForce's importer is pretty primitive and inflexible. AFAIK this is not
unusual; last year I tried the same thing with a MindTouch knowledge base
and that could import only from a .CHM, and even that was plagued with
problems.
SalesForce needs a set of HTML pages saved in a particular nested file
structure, accompanied by a .CSV file that provides the title of each
article, its address, and some other information. The HTML, folders, and
CSV must all be provided in a .ZIP along with a Project file created by the
SalesForce admin.

FM's Save as HTML is buggy, barely supported by Adobe, and its HTML is not
very clean. I could not generate good individual HTML pages from RoboHelp.
Mif2Go offers the flexibility I needed.
To develop the CSV was a different adventure. I needed a list of article
titles mapped to the HTML file names, which are autogenerated with names
like aa100543.htm. I could open each file and copy the title (there is a
Mif2Go setting to make the title match the FM Heading 1 or Heading 2), but
that would be tedious and error-prone for hundreds of files.

Jeremy had a workaround to get my titles and file names together. After
generating the Standard HTML output, I generated OmniHelp output just to
get a single .JS page with the list I needed. I deleted all the rest of the
output, keeping only that file.
Then I edited the file with several search-and-replaces and saved it as
.CSV.

Then I was able to zip together the HTML and the .CSV and hand it off to
the SalesForce Admin, who (after a few false starts) finally reproducibly
imported 24 and then 56 files. We have some bugs, but we think we know how
to fix them.

Now I have to refine the process, learn how to optimize my FM content, and
document it because once the knowledgebase is launched with my existing FM
content, I am committed to updating it forever!

Thanks everyone for all your input on this complex project!
john



On Sun, Aug 4, 2013 at 5:24 PM, John Sgammato wrote:

> Thank you for all the guidance! I hope to get to it tonight
>
> On Sunday, August 4, 2013, Jeremy H. Griffith wrote:
>
>> On Sun, 4 Aug 2013 16:20:31 -0400, John Sgammato <
>> john.sgammato at actifio.com> wrote:
>>
>> >I have no [OmniHelpOptions] at all.
>> >I renamed the HTML version, changing nothing but the name.
>> >That failed, so I tried editing Config= to point to he OmniHelp file -
>> >see below.
>> >I know something's not right, but I don't understand this path well
>> >enough to figure it out.
>>
>> The path looks fine.  I gather you aren't using the
>> Documents template for HTML either?  That's OK,
>> as long as the two projects are the same with that.
>> The rest of your settings look OK.  Oh, add:
>>
>> [HelpContentsLevels]
>> Title=1
>> Heading1=1
>> Heading2=1
>>
>> If you make them all level 1, your first replace
>> will always be of "[1,", no wildcard needed.
>>
>> See par. 7.4.3, "Including contents entries in
>> HTML-based Help".
>>
>> Perhaps I should have been more explicit about
>> what to do in the Choose project dialog.  Select
>> the HTML project, but don't push any buttons yet.
>>
>> Change the name in the top field, and for the
>> second field push [...] and choose the new
>> Omnihelp output directory,  Then select Omnihelp
>> in the last field.
>>
>> NOW, press Add, then OK.  It should go on to the
>> Export dialog, just continue as usual.
>>
>> -- Jeremy H. Griffith, at Omni Systems Inc.
>>   http://mif2go.com/
>> ___
>>
>>
>> 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
>
>

Re: An interesting Mif2Go project - will this work?

2013-08-05 Thread John Sgammato 
Here are some answers, inline;

On Saturday, August 3, 2013, Jeremy H. Griffith wrote:

 On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato 
 john.sgamm...@actifio.com javascript:; wrote:

 I am using FM11 unstructured with Mif2Go to populate a SalesForce
 Knowledge knowledgebase. SalesForce Knowledge is a relatively new
 offering from SaleForce, much better than their older knowledgebase
 product. Ultimately this will involve hundreds of individual topics so
 I want to automate as much of it as I can.
 I have talked to Rick Quatro about this, but there are some other bits
 where I'd appreciate some ideas.
 
 To populate the knowledge base:
 1. I must generate individual HTML files from the FM content and store
 them in a single folder.

 That's the default result.

 2. The SalesForce importer reads a .csv file to get location and other
 info about the content.
 
 The .CSV file looks like this:
 isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
 1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
 PAS_51,sites,en_US
 1,Restoring Selected
 Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US

 Are the first, fourth, fifth, and sixth columns the same
 for all files, or do they vary too?  If they vary, is there
 a rule that describes what they need to be, for your project?


1,4,5,6 are the same for all files



 For this release, I need only the procedures; conceptual information
 can come in the future. (I have it, but I do not want to use it in the
 knowledge base until I do some more development work on it.)
 
 After I generate all the HTML files, I somehow need to get a list of
 the filenames for the third column of the .csv, and I'd love a way to
 get the Title of the topic into the second column.

 We can probably write a CSV file with that info for each
 Frame chapter, then just concatenate them for the full book.

 My plan is to go through the 6 books that will get this treatment and
 apply a new marker to all of the topics that I want for the knowledge
 base.

 Please don't.  Not only is it a large effort, it is not
 necessary from your description above.  The guaranteed
 unique filenames we create will work.  Yours would be
 absolutely guaranteed **not** to be unique,  There is
 a reason we warn against this.


OK - markers are out



 I know how to set the HTML file title = that marker, but I am afraid
 that in the end I will have many surplus files, and they will all have
 autogenerated filenames like ab1101973.htm.

 Even worse.

 Is there a way to automatically set the output *filenames* to match
 the titles? I understand it's a Bad Idea in case I have multiple files
 with the same title, but I will be doing enough post-processing to
 catch and fix that.

 There actually is; we undocumented it for a while
 because of the large number of disasters reported
 to us.  There is *no way* to tell which files were
 clobbered by others until *your* users complain
 about the links going to the wrong places...

 Is there a way to  get only the topics I want and ignore the other
 content?

 How would you identify it?  (Hint: **not** markers.)


Suppose I create two new para formats, procedure looks like Heading2 and
procedure-end is 1pt with nothing in them. Then Mif2go would know the start
and end of each procedure?
X End of new comments x



 I can start a new topic at every H1 and H2, and I can title
 the ones I want from the markers, but in the end I will have a bunch
 of files with near-identical filenames, right? Maybe I can send the
 topics with the markers into a different folder?

 No, that won't work.  The right answer depends on
 your answer to the question above.

 I have some time to work on this, but not a lot - a major release will
 be upon me next week.

 Plenty of time, LOL!

 I have a henchman in India who can help with the FM work, but he
 doesn't know Mif2Go yet.

 This may not be the best time for him to learn.  ;-)

 I appreciate any thoughts to set up a good, solid, reproducible
 process for this.

 A few answers, please, and we can probably provide one.  g

 -- Jeremy H. Griffith, at Omni Systems Inc.
   jer...@omsys.com javascript:;http://mif2go.com/
 ___


 You are currently subscribed to framers as 
 john.sgamm...@actifio.comjavascript:;
 .

 Send list messages to framers@lists.frameusers.com javascript:;.

 To unsubscribe send a blank email to
 framers-unsubscr...@lists.frameusers.com javascript:;
 or visit
 http://lists.frameusers.com/mailman/options/framers/john.sgammato%40actifio.com

 Send administrative questions to listad...@frameusers.com javascript:;.
 Visit
 http://www.frameusers.com/ for more resources and info.



-- 









*John Sgammato  *

Documentation Architect

*e* john.sgamm...@actifio.com

*w* +1-(508) 927-2083

*Recover anything instantly for up to 90% less than you're paying now.*
___


You are currently

Re: An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith 
On Sun, 4 Aug 2013 13:56:49 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I am making progress, but I cannot find an AppManager _ohc.js or any
other _ohc.js file. I can't see any new .js files anywhere in the
project. I got OmniHelp output.
Do I have to turn it on somewhere?

No, it's definitely there.  The name is YOUR project name,
FOLLOWED by _ohc.js.  So if your Frame book is MyFrame.book,
it would be MyFrame_ohc.js.  It is in the output directory.
There are six *_oh?.js files that contain the TOC, index, etc.
for every OmniHelp project.

In possibly related news - I do not have pkzip25 anywhere on my
machine. The log says it was used to make the ship zip, but that's not
so - there's nothing in \ship and I do not even have pkzip.
Should I install it? Or was it supposed to be installed with Mif2Go?

Yikes!  No, that's an *example* entry, in
  %omsyshome%\common\local\configs\local_omsys.ini

;
; Archiving output for distribution
;

[Automation]
; To have Mif2Go or DITA2Go package output, you need an archiving program 
; that can be run from a command line, such as WinZip (wzzip) or PKZip.
; Specify the command to run the archiver:  

; For WinZip (for example):
;ArchiveCommand = c:\program files\winzip\wzzip

; For PKZip (for example):
ArchiveCommand = C:\bin\pkzip25
;
; Command-line parameters required before the archive name:
ArchiveStartParams = -add
; Command-line parameters required after the archive name:
ArchiveEndParams = *.*


You need to edit it to use the command and parameters
of whatever you use to make zips; there are numerous
free programs out there for it.  I suggest 7-zip if
you don't already have one:
  http://www.7-zip.org/


-- 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: An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith 
On Sun, 4 Aug 2013 15:50:36 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I've got 14 oh*.js files, all of them old, and 
none of them AppManager_OHC.js

Then something isn't set up right for the OH project.
If you have set [OmniHelpOptions]ProjectName, it will
use that instead of the book name, but that's not
possible if you used the process I described and
copied your HTML .ini to the OH output dir and then
renamed it.  The HTML inis never have that setting.

You do NOT want to create a new ini for the OH project,
as then the split points may be different between the two.

See par. 10.2.4, Examining generated control and 
data files.

I don't need to ship anything today, so I will deal 
with the zip issue later

The step by step instructions for setting up the
archiver are in par. 35.11, Archiving deliverables.

-- 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: An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith 
On Sun, 4 Aug 2013 16:20:31 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I have no [OmniHelpOptions] at all.
I renamed the HTML version, changing nothing but the name.
That failed, so I tried editing Config= to point to he OmniHelp file -
see below.
I know something's not right, but I don't understand this path well
enough to figure it out.

The path looks fine.  I gather you aren't using the
Documents template for HTML either?  That's OK,
as long as the two projects are the same with that.
The rest of your settings look OK.  Oh, add:

[HelpContentsLevels]
Title=1
Heading1=1
Heading2=1

If you make them all level 1, your first replace
will always be of [1,, no wildcard needed.

See par. 7.4.3, Including contents entries in 
HTML-based Help.

Perhaps I should have been more explicit about
what to do in the Choose project dialog.  Select
the HTML project, but don't push any buttons yet.

Change the name in the top field, and for the 
second field push [...] and choose the new 
Omnihelp output directory,  Then select Omnihelp 
in the last field.

NOW, press Add, then OK.  It should go on to the
Export dialog, just continue as usual.

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

An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith 
On Sun, 4 Aug 2013 01:14:59 -0400, John Sgammato  
wrote:

>Ah! I guess I could just conditionalize the 
>knowledge base and non-kb content...
>It took too long to think of that :(

That would be the most robust method, and
probably the quickest.  I'd suggest that you
conditionalize the NON-KB part. then hide it.

Set up your output directory for HTML below
the Frame book file, as usual, and make
another one for OH next to it.  When you
have the HTML as you want it, copy the
_m2html.ini to the OH directory and rename
it to _m2omnihelp.ini.  Then run the OH
project.

All you want from it is the projname_ohc.js
file.  Delete the first line, and edit the 
last line to match the rest.  Now you can 
do two search/replaces, say in Notepad++,
to replace field 1, "[?,", with "1,", and
the ending "]" with ",PAS_51,sites,en_US".
All done, in a minute or two.  ;-)

Use your list with the HTML files of the
HTML project, not the ones from the OH
project, which have some JS used only by OH.
The filenames and titles will all be identical.

HTH!

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

An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith 
On Sun, 4 Aug 2013 13:56:49 -0400, John Sgammato  
wrote:

>I am making progress, but I cannot find an AppManager _ohc.js or any
>other _ohc.js file. I can't see any new .js files anywhere in the
>project. I got OmniHelp output.
>Do I have to turn it on somewhere?

No, it's definitely there.  The name is YOUR project name,
FOLLOWED by _ohc.js.  So if your Frame book is "MyFrame.book",
it would be "MyFrame_ohc.js".  It is in the output directory.
There are six *_oh?.js files that contain the TOC, index, etc.
for every OmniHelp project.

>In possibly related news - I do not have pkzip25 anywhere on my
>machine. The log says it was used to make the ship zip, but that's not
>so - there's nothing in \ship and I do not even have pkzip.
>Should I install it? Or was it supposed to be installed with Mif2Go?

Yikes!  No, that's an *example* entry, in
  %omsyshome%\common\local\configs\local_omsys.ini

;
; Archiving output for distribution
;

[Automation]
; To have Mif2Go or DITA2Go package output, you need an archiving program 
; that can be run from a command line, such as WinZip (wzzip) or PKZip.
; Specify the command to run the archiver:  

; For WinZip (for example):
;ArchiveCommand = "c:\program files\winzip\wzzip"

; For PKZip (for example):
ArchiveCommand = C:\bin\pkzip25
;
; Command-line parameters required before the archive name:
ArchiveStartParams = -add
; Command-line parameters required after the archive name:
ArchiveEndParams = *.*


You need to edit it to use the command and parameters
of whatever you use to make zips; there are numerous
free programs out there for it.  I suggest 7-zip if
you don't already have one:
  http://www.7-zip.org/


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

An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith 
On Sun, 4 Aug 2013 15:50:36 -0400, John Sgammato  
wrote:

>I've got 14 oh*.js files, all of them old, and 
>none of them AppManager_OHC.js

Then something isn't set up right for the OH project.
If you have set [OmniHelpOptions]ProjectName, it will
use that instead of the book name, but that's not
possible if you used the process I described and
copied your HTML .ini to the OH output dir and then
renamed it.  The HTML inis never have that setting.

You do NOT want to create a new ini for the OH project,
as then the split points may be different between the two.

See par. 10.2.4, "Examining generated control and 
data files".

>I don't need to ship anything today, so I will deal 
>with the zip issue later

The step by step instructions for setting up the
archiver are in par. 35.11, "Archiving deliverables".

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

An interesting Mif2Go project - will this work?

2013-08-04 Thread Jeremy H. Griffith 
On Sun, 4 Aug 2013 16:20:31 -0400, John Sgammato  
wrote:

>I have no [OmniHelpOptions] at all.
>I renamed the HTML version, changing nothing but the name.
>That failed, so I tried editing Config= to point to he OmniHelp file -
>see below.
>I know something's not right, but I don't understand this path well
>enough to figure it out.

The path looks fine.  I gather you aren't using the
Documents template for HTML either?  That's OK,
as long as the two projects are the same with that.
The rest of your settings look OK.  Oh, add:

[HelpContentsLevels]
Title=1
Heading1=1
Heading2=1

If you make them all level 1, your first replace
will always be of "[1,", no wildcard needed.

See par. 7.4.3, "Including contents entries in 
HTML-based Help".

Perhaps I should have been more explicit about
what to do in the Choose project dialog.  Select
the HTML project, but don't push any buttons yet.

Change the name in the top field, and for the 
second field push [...] and choose the new 
Omnihelp output directory,  Then select Omnihelp 
in the last field.

NOW, press Add, then OK.  It should go on to the
Export dialog, just continue as usual.

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

An interesting Mif2Go project - will this work?

2013-08-03 Thread John Sgammato 
I am using FM11 unstructured with Mif2Go to populate a SalesForce
Knowledge knowledgebase. SalesForce Knowledge is a relatively new
offering from SaleForce, much better than their older knowledgebase
product. Ultimately this will involve hundreds of individual topics so
I want to automate as much of it as I can.
I have talked to Rick Quatro about this, but there are some other bits
where I'd appreciate some ideas.

To populate the knowledge base:
1. I must generate individual HTML files from the FM content and store
them in a single folder.
2. The SalesForce importer reads a .csv file to get location and other
info about the content.

The .CSV file looks like this:
isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
PAS_51,sites,en_US
1,Restoring Selected Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US

For this release, I need only the procedures; conceptual information
can come in the future. (I have it, but I do not want to use it in the
knowledge base until I do some more development work on it.)

After I generate all the HTML files, I somehow need to get a list of
the filenames for the third column of the .csv, and I'd love a way to
get the Title of the topic into the second column.

My plan is to go through the 6 books that will get this treatment and
apply a new marker to all of the topics that I want for the knowledge
base.
I know how to set the HTML file title = that marker, but I am afraid
that in the end I will have many surplus files, and they will all have
autogenerated filenames like ab1101973.htm.

Is there a way to automatically set the output *filenames* to match
the titles? I understand it's a Bad Idea in case I have multiple files
with the same title, but I will be doing enough post-processing to
catch and fix that.

Is there a way to  get only the topics I want and ignore the other
content? I can start a new topic at every H1 and H2, and I can title
the ones I want from the markers, but in the end I will have a bunch
of files with near-identical filenames, right? Maybe I can send the
topics with the markers into a different folder?

I have some time to work on this, but not a lot - a major release will
be upon me next week.
I have a henchman in India who can help with the FM work, but he
doesn't know Mif2Go yet.

I appreciate any thoughts to set up a good, solid, reproducible
process for this.
-- 
John Sgammato
Documentation Architect
e john.sgamm...@actifio.com
w +1-(508) 927-2083
Recover anything instantly for up to 90% less than you're paying now.
___


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: An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith 
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato john.sgamm...@actifio.com 
wrote:

I am using FM11 unstructured with Mif2Go to populate a SalesForce
Knowledge knowledgebase. SalesForce Knowledge is a relatively new
offering from SaleForce, much better than their older knowledgebase
product. Ultimately this will involve hundreds of individual topics so
I want to automate as much of it as I can.
I have talked to Rick Quatro about this, but there are some other bits
where I'd appreciate some ideas.

To populate the knowledge base:
1. I must generate individual HTML files from the FM content and store
them in a single folder.

That's the default result.

2. The SalesForce importer reads a .csv file to get location and other
info about the content.

The .CSV file looks like this:
isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
PAS_51,sites,en_US
1,Restoring Selected Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US

Are the first, fourth, fifth, and sixth columns the same
for all files, or do they vary too?  If they vary, is there
a rule that describes what they need to be, for your project?

For this release, I need only the procedures; conceptual information
can come in the future. (I have it, but I do not want to use it in the
knowledge base until I do some more development work on it.)

After I generate all the HTML files, I somehow need to get a list of
the filenames for the third column of the .csv, and I'd love a way to
get the Title of the topic into the second column.

We can probably write a CSV file with that info for each 
Frame chapter, then just concatenate them for the full book.

My plan is to go through the 6 books that will get this treatment and
apply a new marker to all of the topics that I want for the knowledge
base.

Please don't.  Not only is it a large effort, it is not
necessary from your description above.  The guaranteed
unique filenames we create will work.  Yours would be
absolutely guaranteed **not** to be unique,  There is
a reason we warn against this.

I know how to set the HTML file title = that marker, but I am afraid
that in the end I will have many surplus files, and they will all have
autogenerated filenames like ab1101973.htm.

Even worse.

Is there a way to automatically set the output *filenames* to match
the titles? I understand it's a Bad Idea in case I have multiple files
with the same title, but I will be doing enough post-processing to
catch and fix that.

There actually is; we undocumented it for a while
because of the large number of disasters reported 
to us.  There is *no way* to tell which files were 
clobbered by others until *your* users complain 
about the links going to the wrong places...

Is there a way to  get only the topics I want and ignore the other
content? 

How would you identify it?  (Hint: **not** markers.)

I can start a new topic at every H1 and H2, and I can title
the ones I want from the markers, but in the end I will have a bunch
of files with near-identical filenames, right? Maybe I can send the
topics with the markers into a different folder?

No, that won't work.  The right answer depends on 
your answer to the question above.

I have some time to work on this, but not a lot - a major release will
be upon me next week.

Plenty of time, LOL!

I have a henchman in India who can help with the FM work, but he
doesn't know Mif2Go yet.

This may not be the best time for him to learn.  ;-)

I appreciate any thoughts to set up a good, solid, reproducible
process for this.

A few answers, please, and we can probably provide one.  g

-- 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: An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith 
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato 
john.sgamm...@actifio.com wrote:

After I generate all the HTML files, I somehow need to get a list of
the filenames for the third column of the .csv, and I'd love a way to
get the Title of the topic into the second column.

Make an OmniHelp project from one of your books, and 
have a look at the *_ohc.js file.  It has a line for
each topic, with the title and filename.  It's very
close to CSV (and JSON), a JS array:
  [3,2.3 Graphics,graphics.htm#Xxx1363],

The first field is the TOC level.  You can easily
remove the autonumbering and the anchor with ini
settings, leaving:
  [3,Graphics,graphics.htm],
which you can add your other four fields to.

As for exclusion, which do you have more of, excluded
or included?  That will determine the best method.
Have you considered conditional text?  ;-)

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

An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith 
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato  
wrote:

>I am using FM11 unstructured with Mif2Go to populate a SalesForce
>Knowledge knowledgebase. SalesForce Knowledge is a relatively new
>offering from SaleForce, much better than their older knowledgebase
>product. Ultimately this will involve hundreds of individual topics so
>I want to automate as much of it as I can.
>I have talked to Rick Quatro about this, but there are some other bits
>where I'd appreciate some ideas.
>
>To populate the knowledge base:
>1. I must generate individual HTML files from the FM content and store
>them in a single folder.

That's the default result.

>2. The SalesForce importer reads a .csv file to get location and other
>info about the content.
>
>The .CSV file looks like this:
>isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
>1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
>PAS_51,sites,en_US
>1,Restoring Selected Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US

Are the first, fourth, fifth, and sixth columns the same
for all files, or do they vary too?  If they vary, is there
a rule that describes what they need to be, for your project?

>For this release, I need only the procedures; conceptual information
>can come in the future. (I have it, but I do not want to use it in the
>knowledge base until I do some more development work on it.)
>
>After I generate all the HTML files, I somehow need to get a list of
>the filenames for the third column of the .csv, and I'd love a way to
>get the Title of the topic into the second column.

We can probably write a CSV file with that info for each 
Frame chapter, then just concatenate them for the full book.

>My plan is to go through the 6 books that will get this treatment and
>apply a new marker to all of the topics that I want for the knowledge
>base.

Please don't.  Not only is it a large effort, it is not
necessary from your description above.  The guaranteed
unique filenames we create will work.  Yours would be
absolutely guaranteed **not** to be unique,  There is
a reason we warn against this.

>I know how to set the HTML file title = that marker, but I am afraid
>that in the end I will have many surplus files, and they will all have
>autogenerated filenames like ab1101973.htm.

Even worse.

>Is there a way to automatically set the output *filenames* to match
>the titles? I understand it's a Bad Idea in case I have multiple files
>with the same title, but I will be doing enough post-processing to
>catch and fix that.

There actually is; we undocumented it for a while
because of the large number of disasters reported 
to us.  There is *no way* to tell which files were 
clobbered by others until *your* users complain 
about the links going to the wrong places...

>Is there a way to  get only the topics I want and ignore the other
>content? 

How would you identify it?  (Hint: **not** markers.)

>I can start a new topic at every H1 and H2, and I can title
>the ones I want from the markers, but in the end I will have a bunch
>of files with near-identical filenames, right? Maybe I can send the
>topics with the markers into a different folder?

No, that won't work.  The right answer depends on 
your answer to the question above.

>I have some time to work on this, but not a lot - a major release will
>be upon me next week.

Plenty of time, LOL!

>I have a henchman in India who can help with the FM work, but he
>doesn't know Mif2Go yet.

This may not be the best time for him to learn.  ;-)

>I appreciate any thoughts to set up a good, solid, reproducible
>process for this.

A few answers, please, and we can probably provide one.  

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

An interesting Mif2Go project - will this work?

2013-08-03 Thread Jeremy H. Griffith 
On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato 
 wrote:

>After I generate all the HTML files, I somehow need to get a list of
>the filenames for the third column of the .csv, and I'd love a way to
>get the Title of the topic into the second column.

Make an OmniHelp project from one of your books, and 
have a look at the *_ohc.js file.  It has a line for
each topic, with the title and filename.  It's very
close to CSV (and JSON), a JS array:
  [3,"2.3 Graphics","graphics.htm#Xxx1363"],

The first field is the TOC level.  You can easily
remove the autonumbering and the anchor with ini
settings, leaving:
  [3,"Graphics","graphics.htm"],
which you can add your other four fields to.

As for exclusion, which do you have more of, excluded
or included?  That will determine the best method.
Have you considered conditional text?  ;-)

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

An interesting Mif2Go project - will this work?

2013-08-03 Thread John Sgammato 
Here are some answers, inline;

On Saturday, August 3, 2013, Jeremy H. Griffith wrote:

> On Fri, 2 Aug 2013 08:57:56 -0400, John Sgammato <
> john.sgammato at actifio.com > wrote:
>
> >I am using FM11 unstructured with Mif2Go to populate a SalesForce
> >Knowledge knowledgebase. SalesForce Knowledge is a relatively new
> >offering from SaleForce, much better than their older knowledgebase
> >product. Ultimately this will involve hundreds of individual topics so
> >I want to automate as much of it as I can.
> >I have talked to Rick Quatro about this, but there are some other bits
> >where I'd appreciate some ideas.
> >
> >To populate the knowledge base:
> >1. I must generate individual HTML files from the FM content and store
> >them in a single folder.
>
> That's the default result.
>
> >2. The SalesForce importer reads a .csv file to get location and other
> >info about the content.
> >
> >The .CSV file looks like this:
> >isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
> >1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
> >PAS_51,sites,en_US
> >1,Restoring Selected
> Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US
>
> Are the first, fourth, fifth, and sixth columns the same
> for all files, or do they vary too?  If they vary, is there
> a rule that describes what they need to be, for your project?


1,4,5,&6 are the same for all files


>
> >For this release, I need only the procedures; conceptual information
> >can come in the future. (I have it, but I do not want to use it in the
> >knowledge base until I do some more development work on it.)
> >
> >After I generate all the HTML files, I somehow need to get a list of
> >the filenames for the third column of the .csv, and I'd love a way to
> >get the Title of the topic into the second column.
>
> We can probably write a CSV file with that info for each
> Frame chapter, then just concatenate them for the full book.
>
> >My plan is to go through the 6 books that will get this treatment and
> >apply a new marker to all of the topics that I want for the knowledge
> >base.
>
> Please don't.  Not only is it a large effort, it is not
> necessary from your description above.  The guaranteed
> unique filenames we create will work.  Yours would be
> absolutely guaranteed **not** to be unique,  There is
> a reason we warn against this.


OK - markers are out


>
> >I know how to set the HTML file title = that marker, but I am afraid
> >that in the end I will have many surplus files, and they will all have
> >autogenerated filenames like ab1101973.htm.
>
> Even worse.
>
> >Is there a way to automatically set the output *filenames* to match
> >the titles? I understand it's a Bad Idea in case I have multiple files
> >with the same title, but I will be doing enough post-processing to
> >catch and fix that.
>
> There actually is; we undocumented it for a while
> because of the large number of disasters reported
> to us.  There is *no way* to tell which files were
> clobbered by others until *your* users complain
> about the links going to the wrong places...
>
> >Is there a way to  get only the topics I want and ignore the other
> >content?
>
> How would you identify it?  (Hint: **not** markers.)


Suppose I create two new para formats, procedure looks like Heading2 and
procedure-end is 1pt with nothing in them. Then Mif2go would know the start
and end of each procedure?
X End of new comments x


>
> >I can start a new topic at every H1 and H2, and I can title
> >the ones I want from the markers, but in the end I will have a bunch
> >of files with near-identical filenames, right? Maybe I can send the
> >topics with the markers into a different folder?
>
> No, that won't work.  The right answer depends on
> your answer to the question above.
>
> >I have some time to work on this, but not a lot - a major release will
> >be upon me next week.
>
> Plenty of time, LOL!
>
> >I have a henchman in India who can help with the FM work, but he
> >doesn't know Mif2Go yet.
>
> This may not be the best time for him to learn.  ;-)
>
> >I appreciate any thoughts to set up a good, solid, reproducible
> >process for this.
>
> A few answers, please, and we can probably provide one.  
>
> -- Jeremy H. Griffith, at Omni Systems Inc.
>   >http://mif2go.com/
> ___
>
>
> 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*

An interesting Mif2Go project - will this work?

2013-08-02 Thread John Sgammato 
I am using FM11 unstructured with Mif2Go to populate a SalesForce
Knowledge knowledgebase. SalesForce Knowledge is a relatively new
offering from SaleForce, much better than their older knowledgebase
product. Ultimately this will involve hundreds of individual topics so
I want to automate as much of it as I can.
I have talked to Rick Quatro about this, but there are some other bits
where I'd appreciate some ideas.

To populate the knowledge base:
1. I must generate individual HTML files from the FM content and store
them in a single folder.
2. The SalesForce importer reads a .csv file to get location and other
info about the content.

The .CSV file looks like this:
isMasterLanguage,Title.File,datacategorygroup.Products,Channels,Language
1,Forcing Expiry of a Backup Image,/articles/en_US/doc/ab1101973.htm
PAS_51,sites,en_US
1,Restoring Selected Files,/articles/en_US/doc/ab1101043.htm,PAS_51,sites,en_US

For this release, I need only the procedures; conceptual information
can come in the future. (I have it, but I do not want to use it in the
knowledge base until I do some more development work on it.)

After I generate all the HTML files, I somehow need to get a list of
the filenames for the third column of the .csv, and I'd love a way to
get the Title of the topic into the second column.

My plan is to go through the 6 books that will get this treatment and
apply a new marker to all of the topics that I want for the knowledge
base.
I know how to set the HTML file title = that marker, but I am afraid
that in the end I will have many surplus files, and they will all have
autogenerated filenames like ab1101973.htm.

Is there a way to automatically set the output *filenames* to match
the titles? I understand it's a Bad Idea in case I have multiple files
with the same title, but I will be doing enough post-processing to
catch and fix that.

Is there a way to  get only the topics I want and ignore the other
content? I can start a new topic at every H1 and H2, and I can title
the ones I want from the markers, but in the end I will have a bunch
of files with near-identical filenames, right? Maybe I can send the
topics with the markers into a different folder?

I have some time to work on this, but not a lot - a major release will
be upon me next week.
I have a henchman in India who can help with the FM work, but he
doesn't know Mif2Go yet.

I appreciate any thoughts to set up a good, solid, reproducible
process for this.
-- 
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.