[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference vaxuum::online_bookbuilding

Title:Online Bookbuilding
Notice:This conference is write-locked: see note 1.3.
Moderator:VAXUUM::UTT
Created:Fri Aug 12 1988
Last Modified:Mon Jul 15 1991
Last Successful Update:Fri Jun 06 1997
Number of topics:440
Total number of notes:2134

428.0. "OVERHEADS.ONLINE" by RAGMOP::UTT (Mary Utt) Fri May 24 1991 09:42

A prototype doctype is available for creating online versions of overheads.
To use it, you must create a personal doctype (see the DOCUMENT documentation
for general information on personal doctypes):

1. Define the logical name DOC$PERSONAL_FORMATS as described in the
   documentation.

2. Add the following to doc$designs.dat in your doc$personal_formats directory:

   family OVERHEADS
   name 35MM/definitions=TAG$OVERHEADS/macros=TEX$O_35MM/fonts=TEX$STANDARD_FONTS
   name ONLINE/definitions=TAG$O_OVERHEADS.GDX/macros=TEX$O_OVERHEADS/fonts=TEX$STANDARD_FONTS
   endfamily

3. Copy the following files to your doc$personal_formats directory:

   CLOSET::W4_:[PUBLIC]TAG$O_OVERHEADS.GDX
                       TEX$O_OVERHEADS.DESIGN

4. Issue the following command:

   $ DOCUMENT my-slides OVERHEADS.ONLINE BOOKREADER

5. Post any problems or questions as replies to this note.

There is no need to change the SDML files to create an online version of
overheads.

Each slide is a Bookreader 'chunk'. As such, each slide requires a symbol
name, which is generated automatically during tag translation. 

While automatically generated symbol names have limitations, they seemed
adequate for this doctype: 1) there is little (if any) need for symbolic cross
references in overheads and 2) overheads are more static than user
documentation so persistence of symbolic names for creating links is less of an
issue. (See also note 422.17.) 

Because the Bookreader requires a directory into an online document, TOC
entries are generated by the <title> tag and consist of the text argument to
<title>. If <title> is not used, <slide> issues TOC entries consisting of the
text 'Slide 1', 'Slide 2', etc. 

Have fun! 

Mary
T.RTitleUserPersonal
Name
DateLines
428.2looking for files that aren't there....NURSE::BURACKNot Fade AwayTue May 28 1991 12:4027
    Hi,
    
    I did steps 1-4 in note .0 and am getting the following errors:
    
    
    $ D MUG_SLIDES.SDML;5 OVERHEADS.ONLINE BOOKREADER/NOPRIN
    %DOC-I-IDENT, VAX DOCUMENT V2.0-1
    [ T a g    T r a n s l a t i o n ]...
    %TAG-W-ERROPEINC, tag <INCLUDE>, line 41, file
    ZORBA$DUA1:[DOC$TOOLS.PERSONAL]TAG$O_OVERHEADS.GDX;36
    Cannot open included file:   DOC$PERSONAL_FORMATS:TAG$OVERHEADS.GDX
    -RMS-E-FNF, file not found
    -SYSTEM-W-NOSUCHFILE, no such file
    %TAG-W-ERROPEINC, tag <INCLUDE>, line 1, file
    DOC$STANDARD_FORMATS:TAG$ONLINE_TAGS.STT
    Cannot open included file:   TAG$LOCAL_TAGS
    -RMS-E-FNF, file not found
    -SYSTEM-W-NOSUCHFILE, no such file
    %TAG-I-DEFSLOADD, End of Loading of Tag Definitions
    %TAG-W-TAGNOTDEF, tag <UNDEFINED_TAG>, line 4, file  
    .
    .
    .
    
    Thanks,
    
    Ruth-Ellen
428.3sorryRAGMOP::UTTMary UttTue May 28 1991 13:316
    Oops. I had a bad <include> for a tag definition file (worked for me
    because I had the file). Copy a new:
    
     W4_:[PUBLIC]TAG$O_OVERHEADS.GDX
    
    Mary
428.4release noteVAXUUM::UTTMary UttWed May 29 1991 08:5221
    Because there is no front matter <title> tag, the "title" of the
    slides in the Library window is the file name. Thus, if you process
    slides in file 413_slides.sdml, "413_SLIDES" will be the title
    in Bookreader's Library window. 
    
    You can change the title to something more meaningful by editing the
    .decw$bookshelf file generated for the slides. For example, 
    413_slides.decw$bookshelf will have the line:
    
      BOOK\413_slides\413_SLIDES
    
    You can edit it to say:
    
      BOOK\413_slides\101 Fun Things You Can Do with VAX DOCUMENT
    
    Or whatever.
    
    Mary
    
    
    
428.5now a differrent error....NURSE::BURACKNot Fade AwayWed May 29 1991 11:0334
    Hi,
    
    I copied the new file and am now getting:
    
    NURSE>doc mug_slides overheads.online bookreader
    %DOC-I-IDENT, VAX DOCUMENT V2.0-1
    [ T a g    T r a n s l a t i o n ]...
    %TAG-I-DEFSLOADD, End of Loading of Tag Definitions
    %TAG-I-ENDPASS_1, End of first pass over the input
    [ T e x t    F o r m a t t i n g ]...
    %RMS-E-FNF, file not found
    -TEX-I-FILENAME, 'ZORBA$DUA1:[DOC$TOOLS.PERSONAL]TEX$OVERHEADS.DESIGN;'
    %RMS-E-FNF, file not found
    -TEX-I-FILENAME, 'ZORBA$DUA1:[DOC$TOOLS.PERSONAL]TEX$OVERHEADS.DESIGN;'
    %TEX-W-UNDEFINEDCS, Undefined control sequence
    %TEX-I-LINE, Error occurred on or around line number: 12
    %TEX-I-SHOWCONTEXT, '\slide'
    %TEX-I-SHOWCONTEXT, '      {0}'
    %TEX-I-FILENAME, 'NURSE$DKB300:[BURACK.MUG]MUG_SLIDES.TEX;3'
    -TEX-I-ONPAGE, on page [2]
    
    %TEX-W-UNDEFINEDCS, Undefined control sequence
    %TEX-I-LINE, Error occurred on or around line number: 17
    %TEX-I-SHOWCONTEXT, '\subtitle'
    %TEX-I-SHOWCONTEXT, '         {Electronic Publishing
    Software}{0}{0}{0}'
    %TEX-I-FILENAME, 'NURSE$DKB300:[BURACK.MUG]MUG_SLIDES.TEX;3'
    -TEX-I-ONPAGE, on page [2]
    
    and so on.....
    
    Thanks,
    
    Ruth-Ellen
428.6VAXUUM::UTTMary UttWed May 29 1991 14:047
    Oh *&@!, I did the same thing in the design file. Copy a
    new CLOSET::W4_:[PUBLIC]TEX$O_OVERHEADS.DESIGN to your
    personal dir.
    
    Now you know why it's a 'prototype' !
    
    Mary
428.7Got it working...NURSE::BURACKNot Fade AwayWed May 29 1991 16:1022
    Hi,
    
    Works great now!
    
    Output looked good. Noticed that a nest list had too much space between
    it and the text before it:
    
    <list>(unnumbered)
    <le>.......
    <p><text_size>(small)
    .......                          <-------- There was a gap here.
    <list>(unnumbered\-)
    .
    .
    .
    <endlist>
    <endtext_size>
    
    Also, I used <text_size>(small) in slides a lot for paragraphs in
    lists. The list element is not bold and the paragraph text is bold.
    
    
428.8don't forget /CONTENTSNURSE::BURACKNot Fade AwayWed May 29 1991 16:136
    Hi,
    
    You also need to use /CONTENTS on the command line, otherwise you get
    an error.
    
    Ruth-Ellen
428.9VAXUUM::UTTMary UttWed May 29 1991 16:3020
    RE .7: Yes, the formatting (chunking) could use some fine tuning.
    
    RE .8: You shouldn't need /CONTENTS. Check doc$destinations.dat
    in your doc$personal_formats dir. It may have an old destination
    def. For Bookreader it should be:
    
DESTINATION BOOKREADER BOOKR -
 /dvi_filetype=.DVI_BOOKREADER -
 /exclude_action=(print) -
 /required_action=(table_of_contents) -
 /fonts_filetype=.BOOKR_FONTS -
 /format_file=SDMLBOOKR -
 /output_filetype=.DECW$BOOK -
 /special_characters=TEX$BOOKRCHARS
 parameter number HORIZONTAL_OFFSET
 parameter number VERTICAL_OFFSET
 parameter string STARTING_PAGE
 parameter string ENDING_PAGE
 parameter number NUMBER_OF_PAGES