- Add SCR and PIC as image format.
- Bump copyright year.
This commit is contained in:
parent
77f88b0dea
commit
22b07b7150
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=44895
2 changed files with 58 additions and 13 deletions
en_US.ISO8859-1/books/fdp-primer
|
@ -59,6 +59,7 @@
|
|||
<year>2011</year>
|
||||
<year>2012</year>
|
||||
<year>2013</year>
|
||||
<year>2014</year>
|
||||
<holder role="mailto:doceng@FreeBSD.org">DocEng</holder>
|
||||
</copyright>
|
||||
|
||||
|
|
|
@ -2072,24 +2072,68 @@ This is the file called 'foo2'</screen>
|
|||
<sect2 xml:id="docbook-markup-image-formats">
|
||||
<title>Image Formats</title>
|
||||
|
||||
<para>Two image formats are currently supported. The type of
|
||||
image determines which format to use.</para>
|
||||
|
||||
<para>Images that are primarily vector based, such as network
|
||||
diagrams, time lines, and similar, should be in
|
||||
<acronym>EPS</acronym> (Encapsulated Postscript) format.
|
||||
These images have a <filename>.eps</filename>
|
||||
extension.</para>
|
||||
|
||||
<para>For bitmaps, such as screen captures, use the
|
||||
<acronym>PNG</acronym> (Portable Network Graphic) format.
|
||||
These images have the <filename>.png</filename>
|
||||
extension.</para>
|
||||
<para>The following image formats are currently supported. An
|
||||
image file will automatically be converted to bitmap or vector
|
||||
image depending on the output document format.</para>
|
||||
|
||||
<para>These are the <emphasis>only</emphasis> formats in which
|
||||
images should be committed to the documentation
|
||||
repository.</para>
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><acronym>EPS</acronym> (Encapsulated Postscript)</term>
|
||||
|
||||
<listitem>
|
||||
<para>Images that are primarily vector based, such as
|
||||
network diagrams, time lines, and similar, should be in
|
||||
this format. These images have a
|
||||
<filename>.eps</filename> extension.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><acronym>PNG</acronym> (Portable Network Graphic)</term>
|
||||
|
||||
<listitem>
|
||||
<para>For bitmaps, such as screen captures, use this format.
|
||||
These images have the <filename>.png</filename>
|
||||
extension.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><acronym>PIC</acronym> (PIC graphics language)</term>
|
||||
|
||||
<listitem>
|
||||
<para><acronym>PIC</acronym> is a language for drawing
|
||||
simple vector-based figures used in the &man.pic.1;
|
||||
utility. These images have the
|
||||
<filename>.pic</filename> extension.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><acronym>SCR</acronym> (SCReen capture)</term>
|
||||
|
||||
<listitem>
|
||||
<para>This format is specific to screenshots of console
|
||||
output. The following command generates an SCR file
|
||||
<filename>shot.scr</filename> from video buffer of
|
||||
<filename>/dev/ttyv0</filename>:</para>
|
||||
|
||||
<screen>&prompt.root; <userinput><command>vidcontrol -p</command> < <filename><replaceable>/dev/ttyv0</replaceable></filename> > <filename><replaceable>shot.scr</replaceable></filename></userinput></screen>
|
||||
|
||||
<para>This is preferable to <acronym>PNG</acronym> format
|
||||
for screenshots because the <acronym>SCR</acronym> file
|
||||
contains plain text of the command lines so that it can
|
||||
be converted to a <acronym>PNG</acronym> image or a
|
||||
plain text depending on the output document
|
||||
format.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
<para>Use the appropriate format for each image. Documentation
|
||||
will often have a mix of <acronym>EPS</acronym> and
|
||||
<acronym>PNG</acronym> images. The
|
||||
|
|
Loading…
Reference in a new issue