| Title: | DOCUMENT T1.0 |
| Notice: | **New notesfile (DOCUMENT.NOTE) now available (see note 897)** |
| Moderator: | CLOSET::ADLER |
| Created: | Mon Feb 09 1987 |
| Last Modified: | Thu Oct 31 1991 |
| Last Successful Update: | Fri Jun 06 1997 |
| Number of topics: | 897 |
| Total number of notes: | 4397 |
I am trying to make local extentions to the manual. I have so
far managed to re-work the front page, changing the location
of the various text items used in the MANUAL doctype. I have
changed the text at the bottom of the page to our group name.
I have re-worked the copyright page to reflect local needs.
This was hard work to do (not helped by someone having 'borrowed'
my TeX manual), but there are two things that I am having
difficulty with at present, so perhaps someone could help:
A typical problem I want to solve is, say, the addition of
an author tag to the title page which should give output
similar to the revision/udpate line already present.
I have a copy of the tag translator draft manual, which is
great for help on using the <define> tag etc. but I can
find nowhere help on how TeX commands are output. I have
tried "\author|. I have tried <literal>\author<endliteral>,
etc. but always, the tag translator spots the backslash and
stops TeX acting on it in the expected manner.
In writing the \author TeX macro (which I have in a local
TeX extensions file in DOC$PERSONAL_FORMATS), I found it
difficult to match the style of the existing code. This is
because all interesting TeX code is delivered compiled into
.STT files, where I cannot read them. Should the complete
source for the doctypes be on the kit? Copying and changing
is the quickest way to get upto speed on this kind of thing,
I think.
Am I going about this exercise in the correct way, or is
there a much simpler solution?
Also, I would like to do some of the following:-
o Change my doctype so that tables have vertical lines.
o Add a tag to specify single-sided rather than double-
sided output. This is in case we have to produce
documents in a hurry and would like to send out LN03
originals rather than photocopies.
o Be able to integrate the Document fonts into pictures
created outside (in GRED/SIGHT etc.). I guess by some
form of overprinting.
Where does one start with these kind of requirements?
Thanks.
Malcolm Exton (A.I.C.U.)
| T.R | Title | User | Personal Name | Date | Lines |
|---|---|---|---|---|---|
| 819.1 | breaking trail in deep snow | VAXUUM::KOHLBRENNER | Wed Aug 19 1987 10:09 | 55 | |
This is just a reply to two points in your note, the point about
what the tag translator is doing to the TeX output that you
want, and the question about whether you are going about it
in the right way.
There is a "post-translator", that is, another pass over the
output of the tag translator that does all kinds of character
transformations. As you have discovered the backslash that
signals a TeX macro is difficult to output. The reason is that
within argument lists, the backslash is an argument separator.
If you wanted a backslash that would PRINT IN THE OUTPUT, you
would specify <backslash>, and it would get converted into
<literal>(\). But what you want is a backslash that will NOT
BE PRINTED, but will instead be interpreted by TeX as the character
that starts a macro.
The tag translator writes its output to a file with the type INT_TEX.
Backslashes that are to be printed appear in this file as \.
Backslashes that are to be interpreted by TeX appear as control-T.
The post translator then reads the INT_TEX file and writes a TEX
file. It looks for \ and transforms it to "\backslash". It also
looks for control_T and transforms it to \. So the magic comes
from the fact that the desired TeX macros are disguised
in the STT files by coding certain of their characters as control
characters, with reliance on the post translator to put them back
into the form that is expected by TeX.
If you use an editor like EDT you can "see" the control characters
as you type or edit them, so it is a little easier. There is a
tool that converts a GDX file to a GDE file by converting the
control characters into pairs of "visible" characters and there
is another tool that can be used to convert the GDE file back to
its GDX form. This allows you to edit the GDE file with any editor,
even the ones that don't show you the control characters, and then
convert the GDE file back to a GDX file.
So, you are doing the right thing and are stumbling on things that
you should be stumbling on. And of course, if you had the GDX files
instead of the STT files you would be looking at "source code" instead
of "object code," so your sleuthing would be easier.
The main problem is that you are out ahead of us. We haven't made
all this obvious because we haven't had the time to "package" it
and document it so that it can be easily used. With enough "hard
work" you can discover most of it, as you have.
What we tried to do for version 1.0 was to package the major design
decisions regarding layout and to document that in the Doctype Designer's
Guide. The creation of new tags is still to come, along with the TeX
macros.
bill
| |||||
| 819.2 | Nearly there... | MYKENE::EXTON | Now living with a SPYDER:: | Thu Aug 20 1987 07:19 | 23 |
Ah, the mists clear.
After the previous note, some quick Scan and EDT inside .STT
files with the Tag translator manual in one hand and the dec
internal notes in the other, I began to see what is going on.
The problem I had with author was solved by the substitution
of ^T for "\", ^B for "{" and ^E for "}".
I then searched around for the titlepagesysteminfo TeX macro
and I now beleive it is part of standard TeX. This makes my
life much easier in writing the tags, although I have changed
to using the standard <revision_info> tag as it seems to do
the job I wanted.
I presume when you guys implement user-written tags, user's
will not have to enter control characters and the like.
--
The other problems in .0 I do not know how to solve, though.
Malcolm Exton (doc$fan)
| |||||
| 819.3 | we will make it easier | CLOSET::ANKLAM | Thu Aug 20 1987 15:39 | 6 | |
Yes, we will definitely simply this process when we allow users
to create their own tags. For V2, we will also have a powerful
design-building tool for changing formats more easily.
I'm not sure what other problems you mean ?
| |||||
| 819.4 | These problems... | MYKENE::EXTON | Now living with a SPYDER:: | Fri Aug 21 1987 07:28 | 27 |
Patti,
To re-iterate the referenced part of .0:
o Change the look of tables so that vertical lines are present
e.g.:
+------------------+--------------------------+
| col-head1 | col-head2 |
+------------------+--------------------------+
| item | another item |
| item | etc. |
+------------------+--------------------------+
Instead of just horizonatal lines as appear in all doctypes
I have used so far.
o Produce output for single siding - e.g. page numbers all
appear on the rhs of the page instead of alternating.
o Integrating Doc fonts into pictures (I only have access
to an LN03, so the sixel quality for text is poor compared
with the document text).
Also is it possible to rotate standard Doc fonts on the page?
Malcolm
| |||||
| 819.5 | ...are on the wishlist | CLOSET::ANKLAM | Fri Aug 21 1987 11:36 | 12 | |
Most of those items are on the wishlist, i.e.
1. vertical rules in tables
2. Support for specifying either double or single-sided printing
3. Printing in landspace mode
I'm not sure about the fonts in graphics. How are you creating the
sixel files ?
patti
| |||||
| 819.6 | here's how.... | MYKENE::EXTON | Now living with a SPYDER:: | Mon Aug 24 1987 13:04 | 3 |
Re .-1
I am using GRED/SIGHT to create the sixel files...
| |||||