cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
Showing results for 
Search instead for 
Did you mean: 

Community Tip - Your Friends List is a way to easily have access to the community members that you interact with the most! X

Question about SGML docs built from file entities...

JasonBuss
1-Newbie

Question about SGML docs built from file entities...

Hello all,



I have a question regarding the document fragment created by Arbortext
when documents are included as larger documents as file entities.



We have a series of manuals that are being created by combining ATA
pageblocks into a larger document structure using file entities.
Usually the authors don't author directly from the larger document and
edit the individual pageblocks, but these are smaller books (20-30
pageblocks) and part of a project for bringing some legacy manuals
current.



Anyway, they are using the large document to do find/replace against all
the pageblocks. Then they are opening individual pageblocks to make
editing changes specific to those pageblocks. When the find/replace
routine locates and replaces content in a pageblock, the document
fragment kicks in, commenting out the DOCTYPE declaration. So if this
pageblock is opened individually, the context checking is turned off,
since there's no DOCTYPE declaration and no root element declaration.



Is there a way to "toggle" this on and off? I parsed through the help
docs and didn't find specifically what I was looking for. I know I can
do this with some coding, I was trying to see if there was an option or
preference I was missing that would make this simpler.



Thanks,



-Jason

4 REPLIES 4

Hi Jason-



The "set fragmentheader" command might be of some use here. Try setting
it to "document" and see if that clears things up for you.



--Clay



Clay Helberg

Senior Consultant

TerraXML


The normal Arbortext fragement used for file entites has a commented out
set of DOCTYPE information. Arbortext is able to use this information and
open up the fragment individually or as part of the whole document.

Are you using some other application to edit or process these entity
files? this technique of managing file fragments is not standard
methodology outside of Arbortext.

Here is what the cals sampl looks like. the parent document has this info:





NDATA drw>
NDATA drw>



]>

Yet the file entity (testentity.sgm) has this:




The processing instruction actually provides
additional context information to Arbortext to help with numbering schemes
and such. The commented out fragment doctype info contains the graphic
entity declarations that are used in that fragment.

..dan



> Hello all,
>
>
>
> I have a question regarding the document fragment created by Arbortext
> when documents are included as larger documents as file entities.
>
>
>
> We have a series of manuals that are being created by combining ATA
> pageblocks into a larger document structure using file entities.
> Usually the authors don't author directly from the larger document and
> edit the individual pageblocks, but these are smaller books (20-30
> pageblocks) and part of a project for bringing some legacy manuals
> current.
>
>
>
> Anyway, they are using the large document to do find/replace against all
> the pageblocks. Then they are opening individual pageblocks to make
> editing changes specific to those pageblocks. When the find/replace
> routine locates and replaces content in a pageblock, the document
> fragment kicks in, commenting out the DOCTYPE declaration. So if this
> pageblock is opened individually, the context checking is turned off,
> since there's no DOCTYPE declaration and no root element declaration.
>
>
>
> Is there a way to "toggle" this on and off? I parsed through the help
> docs and didn't find specifically what I was looking for. I know I can
> do this with some coding, I was trying to see if there was an option or
> preference I was missing that would make this simpler.
>
>
>
> Thanks,
>
>
>
> -Jason
>
>


And I should have said this fragment doctype allows the fragment to be
edited standalone and provide all the functionality that a normal document
would provide. So context checking and formatting still work.

..dan

> The normal Arbortext fragement used for file entites has a commented out
> set of DOCTYPE information. Arbortext is able to use this information and
> open up the fragment individually or as part of the whole document.
>
> Are you using some other application to edit or process these entity
> files? this technique of managing file fragments is not standard
> methodology outside of Arbortext.
>
> Here is what the cals sampl looks like. the parent document has this info:
>
>
> > [
>
>
>
> > NDATA drw>
> > NDATA drw>
>
>
>
> ]>
>
> Yet the file entity (testentity.sgm) has this:
>
>
>
>
> The processing instruction actually provides
> additional context information to Arbortext to help with numbering schemes
> and such. The commented out fragment doctype info contains the graphic
> entity declarations that are used in that fragment.
>
> ..dan
>
>
>
>> Hello all,
>>
>>
>>
>> I have a question regarding the document fragment created by Arbortext
>> when documents are included as larger documents as file entities.
>>
>>
>>
>> We have a series of manuals that are being created by combining ATA
>> pageblocks into a larger document structure using file entities.
>> Usually the authors don't author directly from the larger document and
>> edit the individual pageblocks, but these are smaller books (20-30
>> pageblocks) and part of a project for bringing some legacy manuals
>> current.
>>
>>
>>
>> Anyway, they are using the large document to do find/replace against all
>> the pageblocks. Then they are opening individual pageblocks to make
>> editing changes specific to those pageblocks. When the find/replace
>> routine locates and replaces content in a pageblock, the document
>> fragment kicks in, commenting out the DOCTYPE declaration. So if this
>> pageblock is opened individually, the context checking is turned off,
>> since there's no DOCTYPE declaration and no root element declaration.
>>
>>
>>
>> Is there a way to "toggle" this on and off? I parsed through the help
>> docs and didn't find specifically what I was looking for. I know I can
>> do this with some coding, I was trying to see if there was an option or
>> preference I was missing that would make this simpler.
>>
>>
>>
>> Thanks,
>>
>>
>>
>> -Jason
>>
>>
>

Jason,

There are two methods of doing this (toggling on/off has not been an issue for me). First is the 'fragment' approach (which is what I'm using for a rather large document I'm working on). The typical header (less all the graphic ENTITIES called out in the DOCTYPE declaration subset) looks like this.


Top Tags