- 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>2011</year>
|
||||||
<year>2012</year>
|
<year>2012</year>
|
||||||
<year>2013</year>
|
<year>2013</year>
|
||||||
|
<year>2014</year>
|
||||||
<holder role="mailto:doceng@FreeBSD.org">DocEng</holder>
|
<holder role="mailto:doceng@FreeBSD.org">DocEng</holder>
|
||||||
</copyright>
|
</copyright>
|
||||||
|
|
||||||
|
|
|
@ -2072,24 +2072,68 @@ This is the file called 'foo2'</screen>
|
||||||
<sect2 xml:id="docbook-markup-image-formats">
|
<sect2 xml:id="docbook-markup-image-formats">
|
||||||
<title>Image Formats</title>
|
<title>Image Formats</title>
|
||||||
|
|
||||||
<para>Two image formats are currently supported. The type of
|
<para>The following image formats are currently supported. An
|
||||||
image determines which format to use.</para>
|
image file will automatically be converted to bitmap or vector
|
||||||
|
image depending on the output document format.</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>These are the <emphasis>only</emphasis> formats in which
|
<para>These are the <emphasis>only</emphasis> formats in which
|
||||||
images should be committed to the documentation
|
images should be committed to the documentation
|
||||||
repository.</para>
|
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
|
<para>Use the appropriate format for each image. Documentation
|
||||||
will often have a mix of <acronym>EPS</acronym> and
|
will often have a mix of <acronym>EPS</acronym> and
|
||||||
<acronym>PNG</acronym> images. The
|
<acronym>PNG</acronym> images. The
|
||||||
|
|
Loading…
Reference in a new issue