openstack/openstack-manuals
Code Issues Proposed changes

Updated image guide to fix cals table and title in pdf and to add toc

Browse Source 
bug: #1183541

Change-Id: Id0812c07fc257e356919d3c125cb8e32c63b7baf
author: diane fleming
This commit is contained in:
Diane Fleming 2013-06-05 13:52:57 -05:00
parent 36c948942d
commit 206ab69d02
3 changed files with 55 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/src/docbkx/openstack-image/bk-imageguide.xml
View File

@ -6,8 +6,10 @@
xmlns:html="http://www.w3.org/1999/xhtml" xmlns:html="http://www.w3.org/1999/xhtml"
version="5.0" version="5.0"
xml:id="openstack-image-manual-trunk"> xml:id="openstack-image-manual-trunk">
<?rax title.font.size="28px" subtitle.font.size="28px"?>
<title>OpenStack Virtual Machine Image Guide</title> <title>OpenStack Virtual Machine Image Guide</title>
<?rax title.font.size="28px" subtitle.font.size="28px"?>
<titleabbrev>VM Image Guide</titleabbrev>
<info> <info>
<author> <author>
<personname> <personname>
@ -15,7 +17,7 @@
<surname/> <surname/>
</personname> </personname>
<affiliation> <affiliation>
<orgname>OpenStack</orgname> <orgname>OpenStack Foundation</orgname>
</affiliation> </affiliation>
</author> </author>
<copyright> <copyright>
@ -23,8 +25,8 @@
<holder>OpenStack Foundation</holder> <holder>OpenStack Foundation</holder>
</copyright> </copyright>
<releaseinfo>current</releaseinfo> <releaseinfo>current</releaseinfo>
<productname>OpenStack Compute</productname> <productname>OpenStack</productname>
<pubdate>2013-05-28</pubdate> <pubdate></pubdate>
<legalnotice role="cc-by"> <legalnotice role="cc-by">
<annotation> <annotation>
<remark>Remaining licensing details are filled in by <remark>Remaining licensing details are filled in by
@ -32,13 +34,23 @@
</annotation> </annotation>
</legalnotice> </legalnotice>
<abstract> <abstract>
<para>This manual describes how to obtain, create, and <para>This guide describes how to obtain, create, and
modify virtual machine images that are compatible with modify virtual machine images that are compatible with
OpenStack. </para> OpenStack. </para>
</abstract> </abstract>
<revhistory> <revhistory>
<!-- ... continue addding more revisions here as you change this document using the markup shown below... --> <!-- ... continue addding more revisions here as you change this document using the markup shown below... -->
<revision> <revision>
<date>2013-06-04</date>
<revdescription>
<itemizedlist>
<listitem>
<para>Updated title for consistency.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
<revision>
<date>2013-05-28</date> <date>2013-05-28</date>
<revdescription> <revdescription>
<itemizedlist> <itemizedlist>

62
doc/src/docbkx/openstack-image/ch_converting.xml
View File

@ -6,42 +6,40 @@
<simplesect> <simplesect>
<title>qemu-img convert: raw, qcow2, VDI, VMDK</title> <title>qemu-img convert: raw, qcow2, VDI, VMDK</title>
<para>The <command>qemu-img convert</command> command can do conversion between multiple <para>The <command>qemu-img convert</command> command can do conversion between multiple
formats, including raw, qcow2, VDI (VirtualBox), VMDK (VMWare) and VHD (Hyper-V).<table formats, including raw, qcow2, VDI (VirtualBox), VMDK (VMWare) and VHD (Hyper-V).</para>
frame="all"> <table
<title>qemu-img format strings</title> rules="all">
<tgroup cols="2"> <caption>qemu-img format strings</caption>
<colspec colname="c1" colnum="1" colwidth="1.0*"/>
<colspec colname="c2" colnum="2" colwidth="1.0*"/>
<thead> <thead>
<row> <tr>
<entry>Image format</entry> <th>Image format</th>
<entry>Argument to qemu-img</entry> <th>Argument to qemu-img</th>
</row> </tr>
</thead> </thead>
<tbody> <tbody>
<row> <tr>
<entry>raw</entry> <td>raw</td>
<entry><literal>raw</literal></entry> <td><literal>raw</literal></td>
</row> </tr>
<row> <tr>
<entry>qcow2</entry> <td>qcow2</td>
<entry><literal>qcow2</literal></entry> <td><literal>qcow2</literal></td>
</row> </tr>
<row> <tr>
<entry>VDI (VirtualBox)</entry> <td>VDI (VirtualBox)</td>
<entry><literal>vdi</literal></entry> <td><literal>vdi</literal></td>
</row> </tr>
<row> <tr>
<entry>VMDK (VMWare)</entry> <td>VMDK (VMWare)</td>
<entry><literal>vmdk</literal></entry> <td><literal>vmdk</literal></td>
</row> </tr>
<row> <tr>
<entry>VHD (Hyper-V)</entry> <td>VHD (Hyper-V)</td>
<entry><literal>vpc</literal></entry> <td><literal>vpc</literal></td>
</row> </tr>
</tbody> </tbody>
</tgroup> </table>
</table></para>
<para>This example will convert a raw image file named centos63.dsk to a qcow2 image file </para> <para>This example will convert a raw image file named centos63.dsk to a qcow2 image file </para>
<para> <para>
<screen><prompt>$</prompt> <userinput>qemu-img convert -f raw -O qcow2 centos64.dsk centos64.qcow2</userinput></screen> <screen><prompt>$</prompt> <userinput>qemu-img convert -f raw -O qcow2 centos64.dsk centos64.qcow2</userinput></screen>

12
doc/src/docbkx/openstack-image/pom.xml
View File

@ -44,10 +44,11 @@
appendix toc,title appendix toc,title
article/appendix nop article/appendix nop
article toc,title article toc,title
book title,figure,table,example,equation book toc,title,figure,table,example,equation
chapter toc,title chapter toc
part toc,title section toc
preface toc,title part toc
preface toc
qandadiv toc qandadiv toc
qandaset toc qandaset toc
reference toc,title reference toc,title
@ -55,6 +56,9 @@
</generateToc> </generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections--> <!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>0</sectionAutolabel> <sectionAutolabel>0</sectionAutolabel>
<formalProcedures>0</formalProcedures>
<tocSectionDepth>1</tocSectionDepth>
<tocChapterDepth>1</tocChapterDepth>
<sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel> <sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel>
<targetDirectory>target/docbkx/webhelp/${release.path.name}</targetDirectory> <targetDirectory>target/docbkx/webhelp/${release.path.name}</targetDirectory>
<webhelpDirname>openstack-image</webhelpDirname> <webhelpDirname>openstack-image</webhelpDirname>