AuthorIT and Structured FrameMaker?

Just wondering if anyone has experience with bringing AuthorIT structured documentation into FrameMaker. I know it's a long shot, but....

Hi Candace,
It doesn't sound like a long shot to me. My guess is that the best approach would be to export (publish) the AuthorIT content as XML and import to structured Frame that way. If you can get a good DITA output from AuthorIT, you may be able to use the DITA structured application included with Frame and avoid the step of creating your own, at least in the initial phases.
Note that my response here is really just a broad summary based on concepts. True implementation would require lots of skills with structured content and could take some time to pull off, depending on the skill set(s) that you are working with. Perhaps I misread your post and you already know all this, and are simply looking for someone who can help you do it...
Russ

Similar Messages

Live eSeminar: Migrating to and Benefiting from Structured Authoring using Adobe FrameMaker 9

A live seminar will be held by Adobe's RJ Jacquez on Friday July 24th. The background info on this is:
Migrating your existing unstructured FrameMaker documents, or Microsoft Word documents to Structured documents in Adobe FrameMaker 9, is much easier than you may think, and the benefits include the ability to enforce authoring consistency, guided authoring, real-time validation and others. In this 90-minute eSeminar, we will explore the differences between unstructured and structured documents, and the overall process of using conversion tables in Adobe FrameMaker 9 for wrapping unstructured styles into structured elements, as well as basic DITA concepts in FrameMaker.
See his blog for sign-up details: http://blogs.adobe.com/rjacquez/2009/07/migrating_to_and_benefiting_fr.html

Usually RJ's presentations are recorded and posted later on his blog
page (http://blogs.adobe.com/rjacquez/). Not sure if all of it will be
relevant to FM8, but some will.

Structured framemaker window does not maximize and other issues

Dear All,
My questions concerns the use of FM11 & FM12 in Structured FrameMaker mode under Windows 8.1.
When FM is started in Structured mode I find that the FrameMaker window is a fraction of the size that it was when operating in Unstructured mode. When the FM (structured) window is maximized instead of the window occupying the full screen as expected it occupies only about 2/3 of the screen. The receptors of dialog buttons (e.g. the OK and CANCEL buttons) are not at the locations of the on screen drawings of the buttons. In short, the Structured FrameMaker interface is not functional. And to be clear the interface of the Unstructured version of the program works in the expected manner.
My reason for operating with Structured FrameMaker in the first place is to workaround a very serious deficiency in the Unstructured version of the program in which attempting to print a book to the Adobe PDF virtual printer causes FrameMaker to crash. Another gripe with FrameMaker is that the Save As PDF file option fails to properly render the document - typically incorrect fonts are used in the output PDF file, equations are clipped, etc. etc. It is this deficiency that means we must print to the Adobe PDF virtual printer.
We are also experiencing intermittent crashing of the program in versions 11 & 12 for no apparent reason whereas previously (version 7, 5.5) the program seemed to be more robust.
Are others experiencing a significant deterioration in the performance of FrameMaker in recent releases? Are you considering changing to a different program? If so, what programs are you considering?
Many thanks,
David.

David,
FYI, the SaveAsPDF route also uses the AdobePDF printer instance, so some of the issues are due to selected output options and Distiller joboptions. Also, both versions (structured and unstructured) use the same output mechanism independent of the interface.
The appearance of the interface is a function of the Workspace selected and any customization done by the user of that interface. You can create your own layouts and save them as required as a custom Workspace.
What did you select when you used the SaveAsPDF - RGB or CMYK? What joboptions file was specified?
Are you using any OTF Pro level or TTF WGL fonts? Is your joboptions file specifying that all fonts be embedded?

Generating HTML from Structured FrameMaker 9

Hi,
My source files are in Structured FrameMaker 9. I need to generate the output in HTML format. Is there a method to do this? Can someone guide me through the process of generating an HTML output?
Regards,
Manish

Hi Manish,
You have a number of options. I'll briefly summarize a few, but all of them involve some measure of complexity so I wouldn't be able to "guide you through" any of them.
- Use a third-party product specifically designed for this, such as Omni Systems' Mif2Go, Quadralay ePublisher, or Adobe Robohelp. If you buy the Adobe TechComm Suite, Robohelp is included. All of these products can convert any FrameMaker document to HTML, with varying levels of additional functionality related to the subsequent generation of common online help formats with that HTML.
- Save your structured files to XML and then use XSLT as a post-process on that XML. This is the more complex option, but if you have the skills, it may be more attractive since you may not have to buy anything and you'll be able to easily customize the process however you want it.
- Use the DITA structure definitions within FrameMaker, then use the DITA Open Toolkit as a post-process to generate HTML from the DITA XML. There is lots of complexity with this as well, but it has some attractiveness as the DITA structured applications and open toolkit are effectively off-the-shelf software. Additionally, everything is free, unless you want to enhance your DITA experience with a third-party addon like DITA FMx from Leximation (recommended).
- Use XHTML as your structure definition within FrameMaker, then save as XML. You'll automatically have HTML when you save your files. FrameMaker includes a structure application for XHTML but I've never used it, so I don't know how well it works. With this option, you would have a more WYSIWYG conveniences while authoring but less control over variations in the HTML output.
There may be more and there certainly are any myriad of combinations of these techiniques. Hopefully this will help get you started. If you did buy the TechComm Suite, consider RoboHelp as a starting point since you already paid for it. The third-party product route is the most expensive in terms of software purchasing, but it is usually the least complex.
One additional note - You will see "Save As HTML" or similar somewhere in the FM menus. It is a very rudimentary feature that is not likely to serve your needs. Might be worth a try since it is already there, but don't get your hopes up on that one.
Good luck,
Russ

How can I get XML cross-references to translate to Structured FrameMaker?

I've been using Structured FrameMaker from the beginning, and have designed many EDDs, and about 10 years ago I did some translation of SGML into Structured FrameMaker (7.2) which worked well.
Now, (with FrameMaker 10), I've had to design an EDD to translate XML documents into Structured FrameMaker.
In my EDD I've a CrossReference element called XRef; this has an attribute of ID, which in turn has a value of IDReference and has Special AttributeConrols of ReadOnly.
My target elements in the EDD all have an ID attribute with a value of UniqueID.
My XML document's target xref element has an attribute of linkend, and in XML this works as I'd expect.
When I pass the XML file through the EDD/Template, everything works except that I get an ID = no value, which, of course, results in no display of the cross-reference data in the document.
Oddly, in structured FrameMaker, my element of link, with an attribute of linkend, works as it should, and displays the data. It may not be important, but the value for linkend is IDReference not UniqueID, and this displays correctly (I changed this attribute's value to Unique ID in my EDD and it made no difference to the XRef value in my document).
After making all these EDD changes, I've been careful to save the changes, import them to all files in my book and finally update the book.   Everything hangs together - except, of course, that the cross-reference doesn't work.
I'd sincerely appreciate any help or advice other users might have because I'm quite frankly stumped.

Russ,
Sorry about the delay in replying; got sidetracked trying to fix some FrameMaker 10 problems; on occasion, it laughs and crashes if we copy an element in a document and paste it to somewhere illegal. This doesn't happen all the time, but it might be something someone might do, so it was interesting to know.
Anyway, back to cross-references.
In our r/w rules we have:
"linkend" is fm attribute "ID";
Can we also have a similar line under the cross-reference element as:
element "xref"
     is fm cross-reference element "XRef";
     attribute "linkend" is fm property cross-reference id;
     attribute "role" is fm property cross-reference format;
At the moment the second line is:
.....attribute ID is fm property cross-reference id;
I tried adding the attribute "linkend" is fm property cross-reference id; (so that I had both linkend and ID) bit but this made no difference.
In general use cross-references work, in that it picks up data in one place in the document, e.g. WorldWideWeb, and repeats it elsewhere.   So in our xml file we have a link element with an attribute linkend which, when it's processed (ignoring the handshake code used to link the two - which could be something vague like 12345vvdog), repeats whatever is the target.
Conversely, for a cross-reference, in xml they use an xref element which also has a linkend attribute (similar mysterious secret handshake behind the scenes) which is deemed to point to a list of references.   This looks like it might be the stumbling block in that it links to an area in the xml document which is used as an internally generated list of references. Apparently this is only built when the xml book equivelent is finalised, so is not, like the link and linkend coupling described above.
I've passed this back to the xml people, and they are investigating a different way of preparing their cross-reference to a list of references (I'm now thoroughly confused with all these references - good thing the weekend's just around the corner).
I appreciate all you help and advice, I'll admit that this is a lot more difficult to understand than straight-forward EDD element creation along with their respective attributes.   Life used to be so much more simple back then!
In sum, what I thought I was doing was allowing an ID attribute with a value of IDReference in my elements, this was deemed to allow for FrameMaker cross-referencing.   In Structured FrameMaker, on its own, this works just fine; it all fell flat on its face when trying to import xml.   I tried to see whether the xref element's ID attribute could also be a UniqueID, but as just about everyone has said, this is a silly idea.   I was just trying stuff to see whether it might make a difference - you'll not be surprised to see that it didn't!
For the moment, I have attributes called ID with a value of IDReference, and I understand you're all suggesting to leave it at that.
If I understand correctly, I could eventually use an IDRef attribute if I wanted a UniqueID value to be used, though I'm not sure what a UniqueID is used or useful for, so will file that for future use.
Again, thanks for the advice and help.
Chris

Broken links when PDF'ing from Structured Framemaker 8.0 in Windows XP

We have a large number of links in our documents that are created using structured Framemaker 8.0 in a Windows XP environment. The xrefs work fine in FM, but once they have been PDF'd all of the links are broken. Since these are large documents, it can take over a day to relink everything. All links are created using the fm-xref tag and link to other topics/items within the FM book.
Any suggestions for what may be the problem?
I am also posting this in the Framemaker forum.

The Set Destination option isn't working for us either.
This is what we are seeing:
In our source doc, a cross-reference is created using the fm-xref structured tag. At that point the cross-reference works. We create a series of topics using cross-references the same way.
These topics are assembled into ditamaps. The cross-references are still working.
A book is then created and all ditamaps are created as chapters within the book.
At this point, the fm-xrefs stop working. In some cases, they were converted to xrefs instead of retaining the fm-xref tag. At this point, some of the formatting is ignored. For example, an example tag that looks lovely in the left column, suddenly becomes a Heading 1 which is a chapter heading.
Needless to say, the frustration level is very high. I would attach, but it appears that .fm or book files are not an acceptable file type.
Please help us. It may be something terribly simple, that we just can't see anymore because we're cross-eyed from troubleshooting.
We love FM and would like to continue to use it, but not if it causes this type of frustration. In fact, we're considering becoming nurses.

Preserving Chapter Cross References when going to Structured Framemaker

Hello,
I am trying to preserve all of my cross references that link from chapter to chapter, within the same book. If I convert files one at a time, then FrameMaker has trouble finding the link in the destination chapter - because that chapter has not yet been converted to Structured FrameMaker.
I have not tried Batch Processing, but I am sure I would get the same results.
With that said, what must I do to these external chapter cross references, so that they convert over to Structured FrameMaker?
Thanks in advance for your response.
Regards,
Jim

Jim,
Like Russ, I have had to redirect the cross-references manually following conversion; HOWEVER, I have also noticed that existing IDs in the unstructured version seem to get put into the converted element as an attribute. In other words, if my EDD defines a Title element with an Id attribute and the unstructured document contains a title paragraph that is the target of a cross-reference, then upon conversion the corresponding Title element has TWO attributes, one is named Id and the other ID. Id has no value, but ID does. The structured document does not validate and I have to delete the ID attribute to make it validate.
This leads me to believe that had I named the attribute ID in my EDD, then it would be assigned a value upon conversion; however, I have never tried this. If I had, FrameMaker would likely create the Title element with two attributes, both named ID!!!
Take it for what it is worth,
Van

Columns in structured framemaker

I was wondering if there is a way to set up columns in a structured framemaker document without messing up the tagging of the document? Thanks. I tried to make a text box and then tried to tag, but it did not work.
Ashley

Ashley,
Text columns are governed by the text frames on the master pages and not the structure of the content. So, on the master page, select the text frame. Select Graphics > Object Properties. The lower left area of the dialog box has a place to specify the number of columns and the amount of space between them. If you also select Balance Columns, then the bottoms of the columns on the last page will more or less align with each other. To switch back to a single column, just change the master page. The structured content remains the same in both cases.
Van

Converting DITA files to Structured FrameMaker

Hello,
I have DITA files need conversion to structured FrameMaker files. I tried generating conversion table with DITA files and defined elements (of structured FrameMaker that I have) against each element in the table. But this is not working.
Is there any other way to accomplish this task?

To add to Scott's reply, make sure when you open your DITA file in Frame, make sure that you are in the Structured interface (Edit > Preferences > General > Product Interface = Structured FrameMaker). If you are not in the Structured interface, FrameMaker will turn your document into an unstructured document - probably not what you want.
Marsha

How are you Using iBooks Author and Samples

I'm curious to see how everyone is using iBooks author to create books. Are most people copy/pasting content into their book or are they directly writing the content in the book? How many have just imported the information from another word processing program? Who is using the program for creating books for children, entertainment or work-related functions?
And that being said, I'm also interseted to see samples of how the books of others look on the iPad, including if possible the children's books, entertainment books or the work-related books. (Including how they incorporated widgets, theme in the pages, fonts, etc)
Me personally, I have been developing two books using iBooks author for work related fuctions. The first book is a training manual for a software program; the second book is a guide to all the reports that can be created in the software program. Both books have been well received by clients.

I generally find that, for creating the text, I'm better off with the word processor of my choice. That way, I get to focus on content and structure and I don't get distracted by layout and formatting issues. While working in the word processor, I use only the simplest of styles. (Logical styles rather than visual ones, the equivalen of HTML <H1>, <H2>, etc.
Once I'm happy with the text and I've done the copy editing, I import into the page layout program and do the layout.
Cheers,
Michi.

Trying to understand structured Framemaker

I want to start a very simple structured Framemaker file, so I can see how it works.
If I select File > New > Explore Structured Templates > Book > Chapter
and I save that file as Chapter,
1. WHERE do I get the EDD from?
The Chapter will compile as an epub.

Use StructureTools > Export Element Catalog as EDD to create an EDD from the document's internal element definitions.
--Lynne

Why page is being unpublished when moving from Manage Content and Structure ?

Hello,
I am getting strange behavior in Manage Content and Structure as below :
when I move published pages from site 1 to site 2 , all moved pages in
site 2 are being unpublished !!
and mention below status :
Status: Checked in and viewable by authorized users.
how to move pages from
Manage Content and Structure so that I don't need to publish the moved pages manually ?
Thanks and Regards,
Dipti
Dipti Chhatrapati

http://www.dotnetspark.com/links/28950-move-page-site-content-and-structure-alters.aspx
http://social.technet.microsoft.com/Forums/en-US/c614408f-d6cf-4d8a-9ab0-46b2ef405824/move-page-in-site-content-and-structure-alters-revision-history-and-makes-old-content-available?forum=sharepointadminlegacy
This is a default behavior as a new content is added to site 2 with a different metadata so it is marked as unpublished

Is there any danger in opening an unstructured document in structured Framemaker?

I know that it's not a good idea to open a structured FrameMaker file in the unstructured FrameMaker interface, and that there's a warning about this when you try.
What's come up for us however is whether there's any problem with people using the Structured FrameMaker interface to edit unstructured files.
We have a machine set up for people who are not expert or highly skilled with FrameMaker, and since we have both structured and unstructured documents, the question is whether to leave it set as the structured interface, or the unstructured interface. They're just making small content edits in most cases, for anything more involved they ask me.
So:
If it's set to unstructured:
If they open an unstructured document, all is well.
If they try to open a structured document, they will see the warning. I can tell them what to do if they see it. (This might mean telling them to change to structured, or just to give me that file to edit instead.)
If it's set to structured:
If they open a structured document, no problem.
If they open an unstructured document however -- is there any danger if they edit it that way? Will saving from structured FrameMaker change anything about the file?
In the latter case, opening unstructured in structured Frame, there's no warning, it just opens with a blank structure view window, if they even open that window.
I have to imagine that Adobe separated the two interfaces for a reason, but possibly it has more to do with just not needing all of the resources like XML and DITA menus when you're in unstructured.
I realize that the real answer is not to let people unskilled with FrameMaker use it to edit documents, but this is the way things are for the moment. If it's set to unstructured, they'll have to switch over in order to edit structured files, and then be sure to remember to switch back. Leaving it set as structured in some ways seems the best choice, but only if it won't damage unstructured files that way.
Thanks

timezoned wrote:
I know that it's not a good idea to open a structured FrameMaker file in the unstructured FrameMaker interface, and that there's a warning about this when you try.
What's come up for us however is whether there's any problem with people using the Structured FrameMaker interface to edit unstructured files.
We have a machine set up for people who are not expert or highly skilled with FrameMaker, and since we have both structured and unstructured documents, the question is whether to leave it set as the structured interface, or the unstructured interface. They're just making small content edits in most cases, for anything more involved they ask me.
So:
If it's set to unstructured:
If they open an unstructured document, all is well.
If they try to open a structured document, they will see the warning. I can tell them what to do if they see it. (This might mean telling them to change to structured, or just to give me that file to edit instead.)
If it's set to structured:
If they open a structured document, no problem.
If they open an unstructured document however -- is there any danger if they edit it that way? Will saving from structured FrameMaker change anything about the file?
In the latter case, opening unstructured in structured Frame, there's no warning, it just opens with a blank structure view window, if they even open that window.
I have to imagine that Adobe separated the two interfaces for a reason, but possibly it has more to do with just not needing all of the resources like XML and DITA menus when you're in unstructured.
I realize that the real answer is not to let people unskilled with FrameMaker use it to edit documents, but this is the way things are for the moment. If it's set to unstructured, they'll have to switch over in order to edit structured files, and then be sure to remember to switch back. Leaving it set as structured in some ways seems the best choice, but only if it won't damage unstructured files that way.
Thanks
As Matt notes, the extra structured stuff in the interface may be confusing to users familiar with unstructured FM. However, it will also be confusing when unstructured FM users try to find and use the paragraph and character catalogs, and some other unstructured features that are perfectly usable in structured FM, but are not immediately visible in the structured interface.
One way to improve and simplify the FM environment for users who are able to edit text, but shouldn't be manipulating other tools, is to customize the interface. Search Google for terms like "customizing framemaker" without quotes. Recent FM releases feature the ExtendScript ToolKit, which offers new ways to customize FM, in addition to those in the older methods of modifying the maker.ini and configui files. One option if you follow this path would be to create custom Windows icons that call startup scripts which then call FM. Before the script launches FM, it can copy specified configuration and ini files into the user's environment, so that when FM starts up, it's got just what you design it to have. A simple approach here would be customize unstructured FM's interface to have only the minimum set of menu items and other things you specify, and launch unstructured FM. An icon could be named for the user, like SallyJonesFM, or for the task, like FMUnStrEditing.
I'm sure some folks on the forum have taken an approach like this for their users, and can offer some advice from their vast experience.
HTH
Regards,
Peter
Peter Gold
KnowHow ProServices

Error while accessing a library using content and structure

I have a library having document and folder inside it. When I open the library using content and structure I get an error with a correlation ID. When checked the the logs with Correlation ID got an error message "View 'All Document' does not exist."
'All Document' is name of default view on the library.
When I open the library from view all site content the library is being opened.
Please help!!!

Hello Victoria,
Thanks for the response.
I have tried troubleshooting steps given by you.
Check if the issue occurs with other users. Use another user to access the library in Content and Structure and then compare the results. --
I tried with different users but no luck
Make sure that the user account with issue has permission to view the All Documents view of the library. --
Yes, user Account have the permission
Check if the issue occurs with other libraries in the Content and Structure. If not, I recommend to save the library as
a template including contents and then create a new library based on this template. After that use the new library instead of the old library. --
No other library have this problem. I cannot save the library as template including the contents as the it has many folders and files. The current size of library is 786 MB
Clear cache in the browser or use another browser to see if the issue still occurs. --
tries but issue persists.
Best regards,
Ratnesh

I am trying to home share with my new MacBook. The music library I am wishing to share is not displaying anywhere on my new laptop under music or library. My computer is authorized and I have tried restarting itunes, etc. Any help/ideas?

I am trying to home share with my new MacBook. The music library I am wishing to share is not displaying anywhere on my new laptop under music or library. My computer is authorized and I have tried restarting itunes, etc. Any help/ideas?

Are you using the same ID for homesharing on all devices.
By the way shared libraries don't show up under either 'Music' or 'Libraries'.

AuthorIT and Structured FrameMaker?

Similar Messages

Maybe you are looking for