Re: FM + CMS + SMEs w/o $$$?

[rinch]

Jack,

My SME's work directly in unstructured
FrameMaker 9. We all work on the same set of files in a shared directory
on our corporate internet. I have a well-defined set of templates, along
with a well-defined set of Corporate Branding Standards and Grammar Standards.
I work closely with the SMEs. I help the SMEs set up the project, train
the SMEs in how to use the FrameMaker templates, edit their work to standards,
and guide the process from start through final approvals to publishing.
My deliverable is always PDF ready to print on standard 8 1/2 x 11 paper.
The PDF is posted on our internet page and/or shipped with product on a
Manuals CD. INFICON is ISO9001:2008 Registered. I am audited regularly.

There are 250 people at my location.
We have 15 copies of FrameMaker that rotate through many different SMEs,
depending on project activity. My Information Systems (IS) department manages
the FrameMaker licenses and installations, IS set up the shared directory,
and IS backs up the shared directory nightly. We've been doing this for
many years. Regular SMEs have become very proficient with FrameMaker. New
SMEs adapt to FrameMaker very quickly. We all have Win7 MSOffice Professional.
The SMEs use MSWord for many of their project documentation activities.
However, they prefer using FM for manuals and other customer-facing documents.

I don't use a CMS. All project related
files are kept in a shared directory. I use Bruce Foster's Archive plugin
to keep everything neat and tidy (and to archive the files to a secure
directory when the project is published.) In the past couple of years I
have looked closely at structured authoring, XML, DITA with a CMS. To me,
this approach is expensive while providing little added value and is therefore
difficult to justify. I agree that just a CMS may be helpful. But, even
just a decent CMS alone is hard to justify given its cost. Our current
methodology works so well for us that I need to see real value-added improvement
to justify the cost of changing. I've not seen them, yet.

My SMEs use FrameMaker 9, a digital
camera (to JPG), and a screen capture program (FullShot or Snagit to PNG).
It used to be that I was the only one to have Photoshop and Illustrator
to edit the JPG and PNG files. But, many of the SMEs have obtained these
programs because they watched what I could do with them, and they want
to use them for their other projects as well (e.g., Engineering Proposals).

Don't be afraid of having your SMEs
use FrameMaker for authoring. As long as you have well-defined templates
backed up by corporate standards, you'll find that your SMEs will not have
any issues with working in FrameMaker. 

Thanks!
Richard

__

Richard Inch
Technical Documentation Manager
Intelligent Sensor Solutions
INFICON
Two Technology Place
East Syracuse, NY 13057-9714
phone: +315.434.2507
fax: +315.437.3803
e-mail: richard.i...@inficon.com
http://www.inficon.com
___

NOTICE: - This message including any attachments is intended only for the
use of the designated recipient(s) named above and may contain confidential
information protected by law. If you are not the intended recipient, you
are hereby notified that any disclosure, copying, distribution, or the
taking of any action in reliance on the contents of this information is
strictly prohibited. If you have received this transmission in error, please
notify the sender immediately by e-mail and delete the original message
including any attachments.



From:   
jackdel...@comcast.net
To:   
framers@lists.frameusers.com
Date:   
01/26/2012 03:56 PM
Subject:  
 FM + CMS + SMEs
w/o $$$?
Sent by:  
 framers-boun...@lists.frameusers.com




All,

I have been tasked with finding a way to allow SME input directly into
our publishing workflow. That is, the developers and managers would be
able to edit text and add graphics to our source files. I want to keep
FrameMaker as the publishing engine. I'm thinking a CMS would be
in order, but the company is aghast at the thought of spending more than
10K a year on word processing. I basically need functionality
something like Author-it that ties into Frame. I could do single-sourcing
with RH (we have TCS3.5). I'm thinking we would have 3 developers
at a time who might be using the system, plus me. That's a budget
of $2500 or less per year per user.

Can anyone point me toward some current resources here? 

Thanks,

Jack DeLand___


You are currently subscribed to framers as ri...@inficon.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/rinch%40inficon.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 

RE: Spellcheck oddness in FM8

[Dave.Stamm]

2012-01-27-05T13:50Z

 

Tim -

 

Makes _great_ sense to me.  My character format is  Resume here:  , indicating 
that this passage needs further work.

 

Dave Stamm

Information Engineer

 

From: framers-boun...@lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of Tim Pann
Sent: 2012-01-26-Thu 12:29
To: Lea Rush; framers@lists.frameusers.com
Subject: RE: Spellcheck oddness in FM8

 

For what it's worth, I create such placeholders using a character format that I 
can then go look for later. (My format is called ATTENTION and it's bold 
magenta underlined. It looks so goofy that I can't miss it even if I forget to 
do a Find for it during the latter part of the release process.)

 

I hope you don't mind me submitting that. I sometimes get annoyed when I ask 
for advice about how to do something and I get a response from someone telling 
me I shouldn't do it. J

 

- Tim

 

From: framers-boun...@lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of Lea Rush
Sent: Thursday, January 26, 2012 8:48 AM
To: framers@lists.frameusers.com
Subject: Spellcheck oddness in FM8

 

Good morning,

 

Frame 8.0p277

Vista Business SP2 (although that doesn't apply here)

 

When stuck for text in a particular spot, I occasionally insert nonsense text 
as a placeholder. When I run spellcheck, it finds the nonsense and I finish the 
section. Yesterday, that tactic failed me. Spellcheck failed to find this:

 

alkasdjf;aidf;andslkfja;oij

 

What??

 

The options for Spellcheck don't seem to yield any clues (screen shot, those 
with text-only email):

 

 

 

That string is also not in user.dct. 

 

Thanks in advance,

Lea

 

 

 


_ 

Lea Rush 
Software and Documentation Specialist 
Astoria-Pacific International 
www.astoria-pacific.com
http://www.a ph: 800-536-3111 
fax:  503-655-7367 
l...@astoria-pacific.com

 

Please consider the environment before printing this email. 
`·.¸¸.·´¯`·.¸.·´¯`·...¸ º`·.¸¸.·´¯`·.¸.·´¯`·...¸º
 
NOTICE OF CONFIDENTIALITY
 
This communication is from Astoria-Pacific International and is intended to be 
confidential and solely for the use of the persons or entities addressed above. 
 If you are not an intended recipient, be aware that the information contained 
herein may be protected from unauthorized use by privilege or law, and any 
copying, distribution, disclosure, or other use of this information is 
prohibited.  If you have received this communication in error, please contact 
the sender by return email or telephone (503) 657-3010 immediately, and delete 
or destroy all copies.  Thank you for your cooperation. 

 

CONFIDENTIALITY NOTICE: The information contained in this message may be 
privileged and/or confidential. If you are not the intended recipient, or 
responsible for delivering this message to the intended recipient, any review, 
forwarding, dissemination, distribution or copying of this communication or any 
attachment(s) is strictly prohibited. If you have received this message in 
error, please notify the sender immediately, and delete it and all attachments 
from your computer and network.

image001.png___


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: FM + CMS + SMEs w/o $$$?

[Art Campbell]

My take on it would be to use a free open source engine such as WordPress
as the CMS (I've been doing this a lot lately -- good solid platform.)

Then use Frame's database publishing capability to to into the MySQL
database that feed the CMS and pull out content. You should also be able to
pull legacy content out of Frame through MIF2go HTML or XML.

No, I haven't done it yet, but all the pieces should theoretically work
together. Some assembly required.
 ;- )

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 Thu, Jan 26, 2012 at 1:58 PM, jackdel...@comcast.net wrote:

 All,

 I have been tasked with finding a way to allow SME input directly into our
 publishing workflow. That is, the developers and managers would be able to
 edit text and add graphics to our source files. I want to keep FrameMaker
 as the publishing engine.  I'm thinking a CMS would be in order, but the
 company is aghast at the thought of spending more than 10K a year on word
 processing.  I basically need functionality something like Author-it that
 ties into Frame.  I could do single-sourcing with RH (we have TCS3.5).  I'm
 thinking we would have 3 developers at a time who might be using the
 system, plus me.  That's a budget of $2500 or less per year per user.

 Can anyone point me toward some current resources here?

 Thanks,

 Jack DeLand

 ___


 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%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: FM + CMS + SMEs w/o $$$?

[John Sgammato]

If you go to structured FM, then the SMEs can write topics in their favorite 
XML/text editor.
But getting structured is a major change that your organization might not be 
ready for.

I would ask the boss to refine the task. Is it for SMEs to publish to users 
without your attention? That’s tricky. But if you have to edit it to company 
standards and do any wordsmithing at all, then they may as well just send you 
content in Word or in an email. In my experience, the reformatting part of it 
is quick compared to making sure the content is complete and accurate for the 
reader.

We are setting off into a project that will include your goal: Our Support crew 
needed a new knowledgebase that includes their Solutions and my product 
documentation. I got involved and suggested MindTouch (which was recommended to 
me by Scott Abel and which you can see in action at the AutoDesk/AutoCad 
knowledgebase).
What we get: All my legacy content becomes nodes in the knowledgebase – each 
procedure, every Heading 1 and Heading 2, becomes a tagged article in the KB. 
All the content is searchable by keyword and by product version.
All new content can be published from FM. The published content is HTML with a 
familiar sort of interface, so Support can continue entering their own 
Solutions, but now they can reference all the product documentation as well. 
Access is role-based, so Services can add their own articles, and make them 
readable internal-only. Articles are commentable, so a user (or a support or 
Services guy) can add comments to clarify or support a procedure, and I can get 
an automatic email notification so I can update the article as needed.
So SMEs can publish content directly, or they can submit it to me, and we get 
hugely-improved functionality as well.
I’ll be happy to answer any questions about my experience as we go through it; 
feel free to contact me directly.

John Sgammato
Principal Technical Writer
Imprivata, Inc

From: framers-boun...@lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of 
jackdel...@comcast.net
Sent: Thursday, January 26, 2012 1:58 PM
To: framers@lists.frameusers.com
Subject: FM + CMS + SMEs w/o $$$?

All,

I have been tasked with finding a way to allow SME input directly into our 
publishing workflow. That is, the developers and managers would be able to edit 
text and add graphics to our source files. I want to keep FrameMaker as the 
publishing engine.  I'm thinking a CMS would be in order, but the company is 
aghast at the thought of spending more than 10K a year on word processing.  I 
basically need functionality something like Author-it that ties into Frame.  I 
could do single-sourcing with RH (we have TCS3.5).  I'm thinking we would have 
3 developers at a time who might be using the system, plus me.  That's a budget 
of $2500 or less per year per user.

Can anyone point me toward some current resources here?

Thanks,

Jack DeLand
___


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: FM + CMS + SMEs w/o $$$?

[D L Reynolds]

 IMHO FM's got an awful steep learning curve for just word processing 

For what it's worth, a colleague has created a customized user interface for FM 
that shows only basic functions; all the fancy stuff that can get you into 
trouble is hidden from the user. This enables non-FM types like admins and 
engineers to use it as if it were a simple word processor, but they can't hose 
things -- at least not creatively.

I can't swear to this, but I think he did the whole thing with changes to the 
maker.ini file.

D L Reynolds
reynolds at semicool.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: FM + CMS + SMEs w/o $$$?

[Lea Rush]

Would you be willing to expand on that, or at least give us your colleague's
contact information? That could address a myriad of issues for my office.
I'm currently the only person who can edit the manuals, and the most likely
backup person to train would likely screw up my manuals beyond imagination.

Thanks,
Lea


_ 
Lea Rush 
Software and Documentation Specialist 
Astoria-Pacific International 
www.astoria-pacific.com
ph: 800-536-3111 
fax:  503-655-7367 
l...@astoria-pacific.com

Please consider the environment before printing this email.
`·.¸¸.·´¯`·.¸.·´¯`·...¸ º`·.¸¸.·´¯`·.¸.·´¯`·...¸º
 
NOTICE OF CONFIDENTIALITY
 
This communication is from Astoria-Pacific International and is intended to
be confidential and solely for the use of the persons or entities addressed
above.  If you are not an intended recipient, be aware that the information
contained herein may be protected from unauthorized use by privilege or law,
and any copying, distribution, disclosure, or other use of this information
is prohibited.  If you have received this communication in error, please
contact the sender by return email or telephone (503) 657-3010 immediately,
and delete or destroy all copies.  Thank you for your cooperation. 

 -Original Message-
 From: framers-boun...@lists.frameusers.com [mailto:framers-
 boun...@lists.frameusers.com] On Behalf Of D L Reynolds
 Sent: Friday, January 27, 2012 10:52 AM
 To: framers@lists.frameusers.com
 Subject: Re: FM + CMS + SMEs w/o $$$?
 
  IMHO FM's got an awful steep learning curve for just word processing
 
 For what it's worth, a colleague has created a customized user interface
for FM
 that shows only basic functions; all the fancy stuff that can get you into
trouble
 is hidden from the user. This enables non-FM types like admins and
engineers to
 use it as if it were a simple word processor, but they can't hose things
-- at least
 not creatively.
 
 I can't swear to this, but I think he did the whole thing with changes to
the
 maker.ini file.
 
 D L Reynolds
 reynolds at semicool.com
 
 
 
 ___
 
 
 You are currently subscribed to framers as l...@astoria-pacific.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/lea%40astoria-
 pacific.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: FM + CMS + SMEs w/o $$$?

[jackdeland]

Ideally, we would have a system that keeps chunks of info that I could let 
others access (with versioning), then I would output the chunks into Frame 
files and/or RoboHelp. 

- Original Message -
From: Jeff Coatsworth jeff.coatswo...@jonassoftware.com 
To: framers@lists.frameusers.com 
Sent: Thursday, January 26, 2012 4:11:21 PM 
Subject: RE: FM + CMS + SMEs w/o $$$? 


IMHO FM's got an awful steep learning curve for just word processing - I'd be 
inclined to just keep them on Word and have them submit docs to you. Or go to 
something wiki-like ( cheap) like Confluence. 


From: framers-boun...@lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of 
jackdel...@comcast.net 
Sent: Thursday, January 26, 2012 1:58 PM 
To: framers@lists.frameusers.com 
Subject: FM + CMS + SMEs w/o $$$? 



All, 

I have been tasked with finding a way to allow SME input directly into our 
publishing workflow. That is, the developers and managers would be able to edit 
text and add graphics to our source files. I want to keep FrameMaker as the 
publishing engine. I'm thinking a CMS would be in order, but the company is 
aghast at the thought of spending more than 10K a year on word processing. I 
basically need functionality something like Author-it that ties into Frame. I 
could do single-sourcing with RH (we have TCS3.5). I'm thinking we would have 3 
developers at a time who might be using the system, plus me. That's a budget of 
$2500 or less per year per user. 

Can anyone point me toward some current resources here? 

Thanks, 

Jack DeLand 

___ 


You are currently subscribed to framers as jackdel...@comcast.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/jackdeland%40comcast.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: FM + CMS + SMEs w/o $$$?

[rebecca officer]

Something XML based? They edit in a free/cheap XML editor, you open the same 
files in FM and publish. I haven't done this so could be talking through a hole 
in my head but it sounds feasible.
 
Steep learning curve for you but prob not for the developers.
 
Cheers
Rebecca

 On 27/01/12 at 10:11, Jeff Coatsworth jeff.coatswo...@jonassoftware.com 
 wrote:

IMHO FM's got an awful steep learning curve for just word processing - I'd be 
inclined to just keep them on Word and have them submit docs to you. Or go to 
something wiki-like ( cheap) like Confluence.

From: framers-boun...@lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of 
jackdel...@comcast.net
Sent: Thursday, January 26, 2012 1:58 PM
To: framers@lists.frameusers.com
Subject: FM + CMS + SMEs w/o $$$?

All,

I have been tasked with finding a way to allow SME input directly into our 
publishing workflow. That is, the developers and managers would be able to edit 
text and add graphics to our source files. I want to keep FrameMaker as the 
publishing engine.  I'm thinking a CMS would be in order, but the company is 
aghast at the thought of spending more than 10K a year on word processing.  I 
basically need functionality something like Author-it that ties into Frame.  I 
could do single-sourcing with RH (we have TCS3.5).  I'm thinking we would have 
3 developers at a time who might be using the system, plus me.  That's a budget 
of $2500 or less per year per user.

Can anyone point me toward some current resources here?  

Thanks,

Jack DeLand

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: Fw: FM + CMS + SMEs w/o $$$?

[Keith . Soltys]

I'm starting to use SmartDocs and will be rolling it out to an initial 
group of about a dozne users, none of whom are technical writers.

It gives Word users a lot of the capabilities that Frame users have had 
for a while: conditional text, reusable variables, and snippets, all of 
which can be combined as you see fit. It uses SharePoint as a repository 
for the SmartDocs content, but your documents can reside anywhere. 

I've been using it to condense multiple versions of specification 
documents into master versions from which I can output snapshots - 
that is versions made up of specific combinations of variables, snippets, 
and conditionals. So far, it seems to be working out pretty well and will 
save me and our group a lot of work in the long run. 

It's very easy to use and seems robust. But it is a Word-only tool. (Word 
2007 and 2010, at that). 

Frame has all of these capabilities, but SmartDocs makes it much easier to 
manage them across multiple documents. I may end up using it for some 
projects that I'd have used Frame for previously, just because it's so 
easy to use. And it's mulit-user, so our group can share reusable content 
across documents and project - something that is a pain to manage in 
Frame. 

Suggestion to any Frame developers out there readomg this: Now that Frame 
has SharePoint integration, look at putting together something like 
SmartDocs for Frame. You'd clean up.

Regards
Keith


 
 I don't really know anything about this product, but Jeff's comment made 

 me think of it: http://www.thirtysix.net/smartdocs/default.aspx
 
 
 Nadine
 
 
 
  From: Jeff Coatsworth jeff.coatswo...@jonassoftware.com
 To: framers@lists.frameusers.com framers@lists.frameusers.com 
 Sent: Thursday, January 26, 2012 4:11:21 PM
 Subject: RE: FM + CMS + SMEs w/o $$$?
  
 
  
 IMHO FM's got an awful steep learning curve for just 
 word processing - I'd be inclined to just keep them on Word and have 
them submit 
 docs to you. Or go to something wiki-like ( cheap) like 
 Confluence.
 

--
Keith Soltys
Senior Technical Writer
Architecture
TMX Group
(416) 947-4397
http://www.tmx.com/



--

NOTICE OF CONFIDENTIALITY

This e-mail, including all materials contained in or attached to this e-mail, 
contains proprietary and confidential information solely for the internal use 
of the intended recipient.  If you have received this email in error, please 
notify us immediately by return e-mail or otherwise and ensure that it is 
permanently deleted from your systems, and do not print, copy, distribute or 
read its contents.



AVIS DE CONFIDENTIALITÉ

Le présent courriel, y compris tous les documents qu'il contient ou qui y sont 
joints, renferme des renseignements exclusifs et confidentiels destinés 
uniquement à l'usage interne du destinataire prévu. Si vous avez reçu le 
présent courriel par erreur, veuillez nous aviser immédiatement, notamment par 
retour de courriel, et vous assurer qu'il est supprimé de façon permanente de 
vos systèmes; veuillez également vous abstenir d'imprimer, de copier, de 
distribuer ou de lire son contenu.

___


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: HTML Generation and Alinks

[Ben Allums]

On 1/26/2012 2:01 PM, Lea Rush wrote:

A couple of years ago, I asked this list about inserting alink targets
directly into my Frame (8.0p277) files so that I wouldn’t have to code
them by hand afterward. A very helpful gentleman whose name I’ve
completely forgotten actually called me to help and spent several
minutes explaining a way that it could be done. Unfortunately, I failed
to completely understand (because what I tried didn’t work), and I gave
up in embarrassment and did it the hard way.

Now my urge to be more efficient have overcome my embarrassment, and I
humbly ask again. Here is the text from my previous request:



I generate CHM from my Frame files (Framemaker 8.0 p277). Is it possible
to add the help targets in Frame directly? I just read an article about
generating the Frame index as you go, and that made me wonder. I’ve
tried a couple of things which I don’t list out of pure embarrassment.
The text of the alink target is this:

param name=ALink Name value=TOPIC:nnn

where “nnn” is a three or four digit target hard-coded into our software.



As before, many TIA,


NOTE: I work for WebWorks.

Lea,

You don't mention how you are generating your CHM files from FrameMaker. 
 If you are working with WebWorks ePublisher, this would be the 
procedure for working with See Also links (ALinks in CHM parlance):


http://www.webworks.com/Documentation/Reverb/index.html#page/03.Preparing%2520and%2520Publishing%2520Content/Preparing%2520FrameMaker%2520Files.1.51.htm


Ben Allums
Director of Engineering
all...@webworks.com
512-381-8885
___


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: FM + CMS + SMEs w/o $$$?

[Jack DeLand]

John,

 

Thank you very much for your detailed reply and kind offer.  To answer your 
question, the SMEs would not be able to publish to user docs; I am the sole 
owner. We (developers and I) do all have access to XML editors, and this may be 
the push I need to finally “go structured”.  

 

We do a lot of work with Federal clients and others who for reasons of security 
do not have access to the Net, and for that reason, web-based solutions such as 
wikis would not reach about 20-22% of our user base.  Internal documentation is 
another circumstance and one that I can’t go into.

 

I’ll do some cogitating about the structured route.  It makes a lot of sense, 
and now would be a perfect time to do it.  

 

Regards,

Jack DeLand

 

From: John Sgammato [mailto:jsgamm...@imprivata.com] 
Sent: Friday, January 27, 2012 9:08 AM
To: 'jackdel...@comcast.net'; framers@lists.frameusers.com
Subject: RE: FM + CMS + SMEs w/o $$$?

 

If you go to structured FM, then the SMEs can write topics in their favorite 
XML/text editor. 

But getting structured is a major change that your organization might not be 
ready for. 

 

I would ask the boss to refine the task. Is it for SMEs to publish to users 
without your attention? That’s tricky. But if you have to edit it to company 
standards and do any wordsmithing at all, then they may as well just send you 
content in Word or in an email. In my experience, the reformatting part of it 
is quick compared to making sure the content is complete and accurate for the 
reader.

 

We are setting off into a project that will include your goal: Our Support crew 
needed a new knowledgebase that includes their Solutions and my product 
documentation. I got involved and suggested MindTouch (which was recommended to 
me by Scott Abel and which you can see in action at the AutoDesk/AutoCad 
knowledgebase).  

What we get: All my legacy content becomes nodes in the knowledgebase – each 
procedure, every Heading 1 and Heading 2, becomes a tagged article in the KB. 
All the content is searchable by keyword and by product version. 

All new content can be published from FM. The published content is HTML with a 
familiar sort of interface, so Support can continue entering their own 
Solutions, but now they can reference all the product documentation as well. 
Access is role-based, so Services can add their own articles, and make them 
readable internal-only. Articles are commentable, so a user (or a support or 
Services guy) can add comments to clarify or support a procedure, and I can get 
an automatic email notification so I can update the article as needed. 

So SMEs can publish content directly, or they can submit it to me, and we get 
hugely-improved functionality as well. 

I’ll be happy to answer any questions about my experience as we go through it; 
feel free to contact me directly.

 

John Sgammato 

Principal Technical Writer

Imprivata, Inc

 

 

From: framers-boun...@lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of 
jackdel...@comcast.net
Sent: Thursday, January 26, 2012 1:58 PM
To: framers@lists.frameusers.com
Subject: FM + CMS + SMEs w/o $$$?

 

All,

I have been tasked with finding a way to allow SME input directly into our 
publishing workflow. That is, the developers and managers would be able to edit 
text and add graphics to our source files. I want to keep FrameMaker as the 
publishing engine.  I'm thinking a CMS would be in order, but the company is 
aghast at the thought of spending more than 10K a year on word processing.  I 
basically need functionality something like Author-it that ties into Frame.  I 
could do single-sourcing with RH (we have TCS3.5).  I'm thinking we would have 
3 developers at a time who might be using the system, plus me.  That's a budget 
of $2500 or less per year per user.

Can anyone point me toward some current resources here?  

Thanks,

Jack DeLand

___


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: HTML Generation and Alinks

[Jeremy H. Griffith]

On Thu, 26 Jan 2012 12:01:24 -0800, Lea Rush l...@astoria-pacific.com wrote:

I generate CHM from my Frame files (Framemaker 8.0 p277). Is it possible to
add the help targets in Frame directly? 

Yes, at least if you are doing it with Mif2Go.  
(You didn't indicate what tool you are using to
create the HTML Help.)  You can do it with markers.  
See the User's Guide, par. 6.6.4.1,  Adding 
related-topic link keywords via markers.

I just read an article about
generating the Frame index as you go, and that made me wonder. I’ve tried a
couple of things which I don’t list out of pure embarrassment. The text of
the alink target is this:

param name=ALink Name value=TOPIC:nnn

where “nnn” is a three or four digit target hard-coded into our software. 

That's one line of a multi-line object element,
and it's not quite the right syntax anyway.  But
you don't have to know the object syntax; Mif2Go
creates that for you.  Your marker would be type
ALink (or another type mapped to that), with
content TOPIC:nnn.

It sounds like you are really using this for CSH,
though, and that can be even simpler; just add
a hypertext newlink marker with the value.  See
par. 8.11.1.1, Using markers for CSH destinations.

The Mif2Go User's Guide can be accessed on line at:
  http://www.omsys.com/dcl/ohusergd/
Or can be downloaded from:
  http://www.omsys.com/dcl/download.htm#Mif2Go_UG

HTH!

-- Jeremy H. Griffith, at Omni Systems Inc.
  jer...@omsys.com  http://www.omsys.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.

Spellcheck oddness in FM8

[Reng, Dr. Winfried]

rom unauthorized use by privilege or law, and any 
copying, distribution, disclosure, or other use of this information is 
prohibited.  If you have received this communication in error, please contact 
the sender by return email or telephone (503) 657-3010 immediately, and delete 
or destroy all copies.  Thank you for your cooperation.



Check out the new Crane Aerospace Electronics 
Newsroom<http://newsroom.craneae.com/>!
Like us on 
Facebook<http://www.facebook.com/home.php?#!/pages/Crane-Aerospace-Electronics/163305413682908>!
We value your opinion! <http://www.craneae.com/surveys/satisfaction.htm>  How 
may we serve you better? Please click the survey link to tell us how we are 
doing: http://www.craneae.com/surveys/satisfaction.htm

Your feedback is of the utmost importance to us. Thank you for your time.

Crane Aerospace & Electronics Confidentiality Statement:
The information contained in this email message may be privileged and is 
confidential information intended only for the use of the recipient, or any 
employee or agent responsible to deliver it to the intended recipient. Any 
unauthorized use, distribution or copying of this information is strictly 
prohibited and may be unlawful. If you have received this communication in 
error, please notify the sender immediately and destroy the original message 
and all attachments from your electronic files.

____
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/8d9a3dbe/attachment.html>
-- next part --
A non-text attachment was scrubbed...
Name: image001.png
Type: image/png
Size: 24553 bytes
Desc: image001.png
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/8d9a3dbe/attachment.png>

FM + CMS + SMEs w/o $$$?

[ri...@inficon.com]

An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/bfeafd74/attachment.html>

Spellcheck oddness in FM8

[dave.st...@gdc4s.com]

2012-01-27-05T13:50Z



Tim -



Makes _great_ sense to me.  My character format is  Resume here:  , indicating 
that "this passage needs further work."



Dave Stamm

Information Engineer



From: framers-bounces at lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of Tim Pann
Sent: 2012-01-26-Thu 12:29
To: Lea Rush; framers at lists.frameusers.com
Subject: RE: Spellcheck oddness in FM8



For what it's worth, I create such placeholders using a character format that I 
can then go look for later. (My format is called "ATTENTION" and it's bold 
magenta underlined. It looks so goofy that I can't miss it even if I forget to 
do a Find for it during the latter part of the release process.)



I hope you don't mind me submitting that. I sometimes get annoyed when I ask 
for advice about how to do something and I get a response from someone telling 
me I shouldn't do it. J



- Tim



From: framers-bounces at lists.frameusers.com 
[mailto:framers-boun...@lists.frameusers.com] On Behalf Of Lea Rush
Sent: Thursday, January 26, 2012 8:48 AM
To: framers at lists.frameusers.com
Subject: Spellcheck oddness in FM8



Good morning,



Frame 8.0p277

Vista Business SP2 (although that doesn't apply here)



When stuck for text in a particular spot, I occasionally insert nonsense text 
as a placeholder. When I run spellcheck, it finds the nonsense and I finish the 
section. Yesterday, that tactic failed me. Spellcheck failed to find this:



alkasdjf;aidf;andslkfja;oij



What??



The options for Spellcheck don't seem to yield any clues (screen shot, those 
with text-only email):







That string is also not in user.dct. 



Thanks in advance,

Lea








_ 

Lea Rush 
Software and Documentation Specialist 
Astoria-Pacific International 
www.astoria-pacific.com
<http://www.a> ph: 800-536-3111 
fax:  503-655-7367 
lea at astoria-pacific.com



Please consider the environment before printing this email. 
`?.??.???`?.?.???`?...? ><?>`?.??.???`?.?.???`?...?><?>

NOTICE OF CONFIDENTIALITY

This communication is from Astoria-Pacific International and is intended to be 
confidential and solely for the use of the persons or entities addressed above. 
 If you are not an intended recipient, be aware that the information contained 
herein may be protected from unauthorized use by privilege or law, and any 
copying, distribution, disclosure, or other use of this information is 
prohibited.  If you have received this communication in error, please contact 
the sender by return email or telephone (503) 657-3010 immediately, and delete 
or destroy all copies.  Thank you for your cooperation. 



CONFIDENTIALITY NOTICE: The information contained in this message may be 
privileged and/or confidential. If you are not the intended recipient, or 
responsible for delivering this message to the intended recipient, any review, 
forwarding, dissemination, distribution or copying of this communication or any 
attachment(s) is strictly prohibited. If you have received this message in 
error, please notify the sender immediately, and delete it and all attachments 
from your computer and network.

-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/d17a29cf/attachment.html>
-- next part --
A non-text attachment was scrubbed...
Name: not available
Type: image/png
Size: 24553 bytes
Desc: image001.png
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/d17a29cf/attachment.png>

FM + CMS + SMEs w/o $$$?

[Art Campbell]

My take on it would be to use a free open source engine such as WordPress
as the CMS (I've been doing this a lot lately -- good solid platform.)

Then use Frame's database publishing capability to to into the MySQL
database that feed the CMS and pull out content. You should also be able to
pull legacy content out of Frame through MIF2go HTML or XML.

No, I haven't done it yet, but all the pieces should theoretically work
together. "Some assembly required."
 ;- )

Art

Art Campbell
  art.campbell at 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 Thu, Jan 26, 2012 at 1:58 PM,  wrote:

> All,
>
> I have been tasked with finding a way to allow SME input directly into our
> publishing workflow. That is, the developers and managers would be able to
> edit text and add graphics to our source files. I want to keep FrameMaker
> as the publishing engine.  I'm thinking a CMS would be in order, but the
> company is aghast at the thought of spending more than 10K a year on "word
> processing".  I basically need functionality something like Author-it that
> ties into Frame.  I could do single-sourcing with RH (we have TCS3.5).  I'm
> thinking we would have 3 developers at a time who might be using the
> system, plus me.  That's a budget of $2500 or less per year per user.
>
> Can anyone point me toward some current resources here?
>
> Thanks,
>
> Jack DeLand
>
> ___
>
>
> You are currently subscribed to framers as art.campbell 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/art.campbell%40gmail.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/20120127/fc2fef4f/attachment.html>

FM + CMS + SMEs w/o $$$?

[John Sgammato]

If you go to structured FM, then the SMEs can write topics in their favorite 
XML/text editor.
But getting structured is a major change that your organization might not be 
ready for.

I would ask the boss to refine the task. Is it for SMEs to publish to users 
without your attention? That?s tricky. But if you have to edit it to company 
standards and do any wordsmithing at all, then they may as well just send you 
content in Word or in an email. In my experience, the reformatting part of it 
is quick compared to making sure the content is complete and accurate for the 
reader.

We are setting off into a project that will include your goal: Our Support crew 
needed a new knowledgebase that includes their Solutions and my product 
documentation. I got involved and suggested MindTouch (which was recommended to 
me by Scott Abel and which you can see in action at the AutoDesk/AutoCad 
knowledgebase).
What we get: All my legacy content becomes nodes in the knowledgebase ? each 
procedure, every Heading 1 and Heading 2, becomes a tagged article in the KB. 
All the content is searchable by keyword and by product version.
All new content can be published from FM. The published content is HTML with a 
familiar sort of interface, so Support can continue entering their own 
Solutions, but now they can reference all the product documentation as well. 
Access is role-based, so Services can add their own articles, and make them 
readable internal-only. Articles are commentable, so a user (or a support or 
Services guy) can add comments to clarify or support a procedure, and I can get 
an automatic email notification so I can update the article as needed.
So SMEs can publish content directly, or they can submit it to me, and we get 
hugely-improved functionality as well.
I?ll be happy to answer any questions about my experience as we go through it; 
feel free to contact me directly.

John Sgammato
Principal Technical Writer
Imprivata, Inc

From: framers-bounces at lists.frameusers.com [mailto:framers-bounces at 
lists.frameusers.com] On Behalf Of jackdel...@comcast.net
Sent: Thursday, January 26, 2012 1:58 PM
To: framers at lists.frameusers.com
Subject: FM + CMS + SMEs w/o $$$?

All,

I have been tasked with finding a way to allow SME input directly into our 
publishing workflow. That is, the developers and managers would be able to edit 
text and add graphics to our source files. I want to keep FrameMaker as the 
publishing engine.  I'm thinking a CMS would be in order, but the company is 
aghast at the thought of spending more than 10K a year on "word processing".  I 
basically need functionality something like Author-it that ties into Frame.  I 
could do single-sourcing with RH (we have TCS3.5).  I'm thinking we would have 
3 developers at a time who might be using the system, plus me.  That's a budget 
of $2500 or less per year per user.

Can anyone point me toward some current resources here?

Thanks,

Jack DeLand
-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/4253b09e/attachment.html>

FM + CMS + SMEs w/o $$$?

[D L Reynolds]

> IMHO FM's got an awful steep learning curve for just word processing 

For what it's worth, a colleague has created a customized user interface for FM 
that shows only basic functions; all the fancy stuff that can get you into 
trouble is hidden from the user. This enables non-FM types like admins and 
engineers to use it as if it were a simple word processor, but they can't hose 
things -- at least not creatively.

I can't swear to this, but I think he did the whole thing with changes to the 
maker.ini file.

D L Reynolds
reynolds at semicool.com

FM + CMS + SMEs w/o $$$?

[Lea Rush]

Would you be willing to expand on that, or at least give us your colleague's
contact information? That could address a myriad of issues for my office.
I'm currently the only person who can edit the manuals, and the most likely
backup person to train would likely screw up my manuals beyond imagination.

Thanks,
Lea


_ 
Lea Rush 
Software and Documentation Specialist 
Astoria-Pacific International 
www.astoria-pacific.com
ph: 800-536-3111 
fax:? 503-655-7367 
lea at astoria-pacific.com

Please consider the environment before printing this email.
`?.??.???`?.?.???`?...? >`?.??.???`?.?.???`?...?>
?
NOTICE OF CONFIDENTIALITY
?
This communication is from Astoria-Pacific International and is intended to
be confidential and solely for the use of the persons or entities addressed
above.? If you are not an intended recipient, be aware that the information
contained herein may be protected from unauthorized use by privilege or law,
and any copying, distribution, disclosure, or other use of this information
is prohibited.? If you have received this communication in error, please
contact the sender by return email or telephone (503) 657-3010 immediately,
and delete or destroy all copies.? Thank you for your cooperation. 

> -Original Message-
> From: framers-bounces at lists.frameusers.com [mailto:framers-
> bounces at lists.frameusers.com] On Behalf Of D L Reynolds
> Sent: Friday, January 27, 2012 10:52 AM
> To: framers at lists.frameusers.com
> Subject: Re: FM + CMS + SMEs w/o $$$?
> 
> > IMHO FM's got an awful steep learning curve for just word processing
> 
> For what it's worth, a colleague has created a customized user interface
for FM
> that shows only basic functions; all the fancy stuff that can get you into
trouble
> is hidden from the user. This enables non-FM types like admins and
engineers to
> use it as if it were a simple word processor, but they can't hose things
-- at least
> not creatively.
> 
> I can't swear to this, but I think he did the whole thing with changes to
the
> maker.ini file.
> 
> D L Reynolds
> reynolds at semicool.com
> 
> 
> 
> ___
> 
> 
> You are currently subscribed to framers as lea at astoria-pacific.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/lea%40astoria-
> pacific.com
> 
> Send administrative questions to listadmin at frameusers.com. Visit
> http://www.frameusers.com/ for more resources and info.

FM + CMS + SMEs w/o $$$?

[rebecca officer]

Something XML based? They edit in a free/cheap XML editor, you open the same 
files in FM and publish. I haven't done this so could be talking through a hole 
in my head but it sounds feasible.

Steep learning curve for you but prob not for the developers.

Cheers
Rebecca

>>> On 27/01/12 at 10:11, Jeff Coatsworth >> jonassoftware.com> wrote:

IMHO FM's got an awful steep learning curve for just word processing - I'd be 
inclined to just keep them on Word and have them submit docs to you. Or go to 
something wiki-like (& cheap) like Confluence.

From: framers-bounces at lists.frameusers.com [mailto:framers-bounces at 
lists.frameusers.com] On Behalf Of jackdel...@comcast.net
Sent: Thursday, January 26, 2012 1:58 PM
To: framers at lists.frameusers.com
Subject: FM + CMS + SMEs w/o $$$?

All,

I have been tasked with finding a way to allow SME input directly into our 
publishing workflow. That is, the developers and managers would be able to edit 
text and add graphics to our source files. I want to keep FrameMaker as the 
publishing engine.  I'm thinking a CMS would be in order, but the company is 
aghast at the thought of spending more than 10K a year on "word processing".  I 
basically need functionality something like Author-it that ties into Frame.  I 
could do single-sourcing with RH (we have TCS3.5).  I'm thinking we would have 
3 developers at a time who might be using the system, plus me.  That's a budget 
of $2500 or less per year per user.

Can anyone point me toward some current resources here?  

Thanks,

Jack DeLand

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/20120127/7bde85ef/attachment.html>

Fw: FM + CMS + SMEs w/o $$$?

[keith.sol...@tmx.com]

I'm starting to use SmartDocs and will be rolling it out to an initial 
group of about a dozne users, none of whom are technical writers.

It gives Word users a lot of the capabilities that Frame users have had 
for a while: conditional text, reusable variables, and snippets, all of 
which can be combined as you see fit. It uses SharePoint as a repository 
for the SmartDocs content, but your documents can reside anywhere. 

I've been using it to condense multiple versions of specification 
documents into "master" versions from which I can output "snapshots" - 
that is versions made up of specific combinations of variables, snippets, 
and conditionals. So far, it seems to be working out pretty well and will 
save me and our group a lot of work in the long run. 

It's very easy to use and seems robust. But it is a Word-only tool. (Word 
2007 and 2010, at that). 

Frame has all of these capabilities, but SmartDocs makes it much easier to 
manage them across multiple documents. I may end up using it for some 
projects that I'd have used Frame for previously, just because it's so 
easy to use. And it's mulit-user, so our group can share reusable content 
across documents and project - something that is a pain to manage in 
Frame. 

Suggestion to any Frame developers out there readomg this: Now that Frame 
has SharePoint integration, look at putting together something like 
SmartDocs for Frame. You'd clean up.

Regards
Keith


> 
> I don't really know anything about this product, but Jeff's comment made 

> me think of it: http://www.thirtysix.net/smartdocs/default.aspx
> 
> 
> >Nadine
> 
> 
> >>
> >> From: Jeff Coatsworth 
> >>To: "framers at lists.frameusers.com"  
> >>Sent: Thursday, January 26, 2012 4:11:21 PM
> >>Subject: RE: FM + CMS + SMEs w/o $$$?
> >> 
> >>
> >> 
> >>IMHO FM's got an awful steep learning curve for just 
> word processing - I'd be inclined to just keep them on Word and have 
them submit 
> docs to you. Or go to something wiki-like (& cheap) like 
> Confluence.
> >>

--
Keith Soltys
Senior Technical Writer
Architecture
TMX Group
(416) 947-4397
http://www.tmx.com/



--

NOTICE OF CONFIDENTIALITY

This e-mail, including all materials contained in or attached to this e-mail, 
contains proprietary and confidential information solely for the internal use 
of the intended recipient.  If you have received this email in error, please 
notify us immediately by return e-mail or otherwise and ensure that it is 
permanently deleted from your systems, and do not print, copy, distribute or 
read its contents.



AVIS DE CONFIDENTIALIT?

Le pr?sent courriel, y compris tous les documents qu'il contient ou qui y sont 
joints, renferme des renseignements exclusifs et confidentiels destin?s 
uniquement ? l'usage interne du destinataire pr?vu. Si vous avez re?u le 
pr?sent courriel par erreur, veuillez nous aviser imm?diatement, notamment par 
retour de courriel, et vous assurer qu'il est supprim? de fa?on permanente de 
vos syst?mes; veuillez ?galement vous abstenir d'imprimer, de copier, de 
distribuer ou de lire son contenu.

HTML Generation and Alinks

[Ben Allums]

On 1/26/2012 2:01 PM, Lea Rush wrote:
> A couple of years ago, I asked this list about inserting alink targets
> directly into my Frame (8.0p277) files so that I wouldn?t have to code
> them by hand afterward. A very helpful gentleman whose name I?ve
> completely forgotten actually called me to help and spent several
> minutes explaining a way that it could be done. Unfortunately, I failed
> to completely understand (because what I tried didn?t work), and I gave
> up in embarrassment and did it the hard way.
>
> Now my urge to be more efficient have overcome my embarrassment, and I
> humbly ask again. Here is the text from my previous request:
>
> 
>
> I generate CHM from my Frame files (Framemaker 8.0 p277). Is it possible
> to add the help targets in Frame directly? I just read an article about
> generating the Frame index as you go, and that made me wonder. I?ve
> tried a couple of things which I don?t list out of pure embarrassment.
> The text of the alink target is this:
>
> 
>
> where ?nnn? is a three or four digit target hard-coded into our software.
>
> 
>
> As before, many TIA,

NOTE: I work for WebWorks.

Lea,

You don't mention how you are generating your CHM files from FrameMaker. 
  If you are working with WebWorks ePublisher, this would be the 
procedure for working with See Also links (ALinks in CHM parlance):




Ben Allums
Director of Engineering
allums at webworks.com
512-381-8885

FM + CMS + SMEs w/o $$$?

[Jack DeLand]

John,



Thank you very much for your detailed reply and kind offer.  To answer your 
question, the SMEs would not be able to publish to user docs; I am the sole 
owner. We (developers and I) do all have access to XML editors, and this may be 
the push I need to finally ?go structured?.  



We do a lot of work with Federal clients and others who for reasons of security 
do not have access to the Net, and for that reason, web-based solutions such as 
wikis would not reach about 20-22% of our user base.  Internal documentation is 
another circumstance and one that I can?t go into.



I?ll do some cogitating about the structured route.  It makes a lot of sense, 
and now would be a perfect time to do it.  



Regards,

Jack DeLand



From: John Sgammato [mailto:jsgamm...@imprivata.com] 
Sent: Friday, January 27, 2012 9:08 AM
To: 'jackdeland at comcast.net'; framers at lists.frameusers.com
Subject: RE: FM + CMS + SMEs w/o $$$?



If you go to structured FM, then the SMEs can write topics in their favorite 
XML/text editor. 

But getting structured is a major change that your organization might not be 
ready for. 



I would ask the boss to refine the task. Is it for SMEs to publish to users 
without your attention? That?s tricky. But if you have to edit it to company 
standards and do any wordsmithing at all, then they may as well just send you 
content in Word or in an email. In my experience, the reformatting part of it 
is quick compared to making sure the content is complete and accurate for the 
reader.



We are setting off into a project that will include your goal: Our Support crew 
needed a new knowledgebase that includes their Solutions and my product 
documentation. I got involved and suggested MindTouch (which was recommended to 
me by Scott Abel and which you can see in action at the AutoDesk/AutoCad 
knowledgebase).  

What we get: All my legacy content becomes nodes in the knowledgebase ? each 
procedure, every Heading 1 and Heading 2, becomes a tagged article in the KB. 
All the content is searchable by keyword and by product version. 

All new content can be published from FM. The published content is HTML with a 
familiar sort of interface, so Support can continue entering their own 
Solutions, but now they can reference all the product documentation as well. 
Access is role-based, so Services can add their own articles, and make them 
readable internal-only. Articles are commentable, so a user (or a support or 
Services guy) can add comments to clarify or support a procedure, and I can get 
an automatic email notification so I can update the article as needed. 

So SMEs can publish content directly, or they can submit it to me, and we get 
hugely-improved functionality as well. 

I?ll be happy to answer any questions about my experience as we go through it; 
feel free to contact me directly.



John Sgammato 

Principal Technical Writer

Imprivata, Inc





From: framers-bounces at lists.frameusers.com [mailto:framers-bounces at 
lists.frameusers.com] On Behalf Of jackdel...@comcast.net
Sent: Thursday, January 26, 2012 1:58 PM
To: framers at lists.frameusers.com
Subject: FM + CMS + SMEs w/o $$$?



All,

I have been tasked with finding a way to allow SME input directly into our 
publishing workflow. That is, the developers and managers would be able to edit 
text and add graphics to our source files. I want to keep FrameMaker as the 
publishing engine.  I'm thinking a CMS would be in order, but the company is 
aghast at the thought of spending more than 10K a year on "word processing".  I 
basically need functionality something like Author-it that ties into Frame.  I 
could do single-sourcing with RH (we have TCS3.5).  I'm thinking we would have 
3 developers at a time who might be using the system, plus me.  That's a budget 
of $2500 or less per year per user.

Can anyone point me toward some current resources here?  

Thanks,

Jack DeLand

-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/147faafd/attachment.html>

HTML Generation and Alinks

[Jeremy H. Griffith]

On Thu, 26 Jan 2012 12:01:24 -0800, "Lea Rush"  
wrote:

>I generate CHM from my Frame files (Framemaker 8.0 p277). Is it possible to
>add the help targets in Frame directly? 

Yes, at least if you are doing it with Mif2Go.  
(You didn't indicate what tool you are using to
create the HTML Help.)  You can do it with markers.  
See the User's Guide, par. 6.6.4.1,  "Adding 
related-topic link keywords via markers".

>I just read an article about
>generating the Frame index as you go, and that made me wonder. I?ve tried a
>couple of things which I don?t list out of pure embarrassment. The text of
>the alink target is this:
>
>
>
>where ?nnn? is a three or four digit target hard-coded into our software. 

That's one line of a multi-line  element,
and it's not quite the right syntax anyway.  But
you don't have to know the object syntax; Mif2Go
creates that for you.  Your marker would be type
ALink (or another type mapped to that), with
content TOPIC:nnn.

It sounds like you are really using this for CSH,
though, and that can be even simpler; just add
a hypertext newlink marker with the value.  See
par. 8.11.1.1, "Using markers for CSH destinations".

The Mif2Go User's Guide can be accessed on line at:
  http://www.omsys.com/dcl/ohusergd/
Or can be downloaded from:
  http://www.omsys.com/dcl/download.htm#Mif2Go_UG

HTH!

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

FM + CMS + SMEs w/o $$$?

[Jack DeLand]

 system,
plus me.  That's a budget of $2500 or less per year per user.

Can anyone point me toward some current resources here?  

Thanks,

Jack DeLand___


You are currently subscribed to framers as rinch at inficon.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/rinch%40inficon.com>
http://lists.frameusers.com/mailman/options/framers/rinch%40inficon.com

Send administrative questions to listadmin at frameusers.com. Visit
 <http://www.frameusers.com/> http://www.frameusers.com/ for more resources
and info.

-- next part --
An HTML attachment was scrubbed...
URL: 
<http://lists.frameusers.com/pipermail/framers/attachments/20120127/2cc50bc0/attachment.html>