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"
version="5.0"
xml:id="openstack-image-manual-trunk">
<?rax title.font.size="28px" subtitle.font.size="28px"?>
<title>OpenStack Virtual Machine Image Guide</title>
<?rax title.font.size="28px" subtitle.font.size="28px"?>
<titleabbrev>VM Image Guide</titleabbrev>
<info>
<author>
<personname>
@ -15,7 +17,7 @@
<surname/>
</personname>
<affiliation>
<orgname>OpenStack</orgname>
<orgname>OpenStack Foundation</orgname>
</affiliation>
</author>
<copyright>
@ -23,8 +25,8 @@
<holder>OpenStack Foundation</holder>
</copyright>
<releaseinfo>current</releaseinfo>
<productname>OpenStack Compute</productname>
<pubdate>2013-05-28</pubdate>
<productname>OpenStack</productname>
<pubdate></pubdate>
<legalnotice role="cc-by">
<annotation>
<remark>Remaining licensing details are filled in by
@ -32,13 +34,23 @@
</annotation>
</legalnotice>
<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
OpenStack. </para>
</abstract>
<revhistory>
<!-- ... continue addding more revisions here as you change this document using the markup shown below... -->
<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>
<revdescription>
<itemizedlist>

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

@ -6,42 +6,40 @@
<simplesect>
<title>qemu-img convert: raw, qcow2, VDI, VMDK</title>
<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
frame="all">
<title>qemu-img format strings</title>
<tgroup cols="2">
<colspec colname="c1" colnum="1" colwidth="1.0*"/>
<colspec colname="c2" colnum="2" colwidth="1.0*"/>
formats, including raw, qcow2, VDI (VirtualBox), VMDK (VMWare) and VHD (Hyper-V).</para>
<table
rules="all">
<caption>qemu-img format strings</caption>
<thead>
<row>
<entry>Image format</entry>
<entry>Argument to qemu-img</entry>
</row>
<tr>
<th>Image format</th>
<th>Argument to qemu-img</th>
</tr>
</thead>
<tbody>
<row>
<entry>raw</entry>
<entry><literal>raw</literal></entry>
</row>
<row>
<entry>qcow2</entry>
<entry><literal>qcow2</literal></entry>
</row>
<row>
<entry>VDI (VirtualBox)</entry>
<entry><literal>vdi</literal></entry>
</row>
<row>
<entry>VMDK (VMWare)</entry>
<entry><literal>vmdk</literal></entry>
</row>
<row>
<entry>VHD (Hyper-V)</entry>
<entry><literal>vpc</literal></entry>
</row>
<tr>
<td>raw</td>
<td><literal>raw</literal></td>
</tr>
<tr>
<td>qcow2</td>
<td><literal>qcow2</literal></td>
</tr>
<tr>
<td>VDI (VirtualBox)</td>
<td><literal>vdi</literal></td>
</tr>
<tr>
<td>VMDK (VMWare)</td>
<td><literal>vmdk</literal></td>
</tr>
<tr>
<td>VHD (Hyper-V)</td>
<td><literal>vpc</literal></td>
</tr>
</tbody>
</tgroup>
</table></para>
</table>
<para>This example will convert a raw image file named centos63.dsk to a qcow2 image file </para>
<para>
<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
article/appendix nop
article toc,title
book title,figure,table,example,equation
chapter toc,title
part toc,title
preface toc,title
book toc,title,figure,table,example,equation
chapter toc
section toc
part toc
preface toc
qandadiv toc
qandaset toc
reference toc,title
@ -55,6 +56,9 @@
</generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>0</sectionAutolabel>
<formalProcedures>0</formalProcedures>
<tocSectionDepth>1</tocSectionDepth>
<tocChapterDepth>1</tocChapterDepth>
<sectionLabelIncludesComponentLabel>0</sectionLabelIncludesComponentLabel>
<targetDirectory>target/docbkx/webhelp/${release.path.name}</targetDirectory>
<webhelpDirname>openstack-image</webhelpDirname>