Am Mon, 08 Aug 2005 12:28:39 -0500 hat Janet M. Swisher
<[EMAIL PROTECTED]> geschrieben:
Hinrich Schmieta wrote:
Hi Rick,
I have a comparable problem when quoting code.
The template style OOoComputerCode makes the code hard to read.
A courier font in a smaller size then 12 point with a light grey
background would be my preference. Line numbering could be helpfull as
well.
Regards
Hinrich
What is the convention we are using for quoting blocks of code? I am
writing the Calc chapter on macros and I want to be able to refer back
to the code with a standard reference like 'figure 1', 'table 1'...etc.
Hi Hinrich,
Can you tell me in more detail why you find the OOoComputerCode style
hard to read? I find it more common that people complain about *smaller*
point sizes being hard to read, not larger ones.
Hi Janet,
the idea of a smaller font is that it would allow better to reproduce the
original formatting of the computer code. In the document I am working on
I have lots of additional line breaks only because of the 'big'
OOo-formating. Most programmers are aiming to give their code a
meaningfull format. Indenting if-clauses is a common and simple example.
The original format usually makes the structure of the code more visible
and clearer. Any additional line break is confusing here, especially for
learners.
Screenshots from the quoted blocks of code would be ideal for keeping the
format, but users would not be able to copy and paste the code for their
own purposes.
What leads you suggest a gray background? Would that make the computer
code itself easier to read, or just set it off from the regular text of
the document?
May be it is a convention I got used to, yes a grey background clearly
sets off the code from the rest of the document.
It would be possible to add support for numbering lines of code, but it
would require updating our template, which isn't likely to happen soon.
OOo Writer supports line numbering, but by default it numbers all the
lines in the document. We'd have to change all our paragraph styles
except OOoComputerCode to turn off the "Include this paragraph in line
numbering" option.
Line numbering would be very helpfull when explaining for example where to
change the code to connect to a special database in the users system.
Thanks,
--
Hinrich Schmieta
Meller Straße 19
33613 Bielefeld
0531 5 24 67 68
[EMAIL PROTECTED]
www.schmieta.de
