[PATCH 0/6] Add mechanism to translate help pages
From: Aline Manera <alinefm@br.ibm.com> This patch set updates the build process and also de UI to get translated help pages. Aline Manera (6): Replicate help pages for pt_BR and zh_CN Update build process to generate html pages for each help subdir help pages: Remove former .dita files help pages: Adjust css url help pages: Update .gitignore file help pages: Set default index file to /help URI .gitignore | 2 +- configure.ac | 3 + contrib/kimchi.spec.fedora.in | 2 +- contrib/kimchi.spec.suse.in | 2 +- src/kimchi/config.py.in | 1 + ui/js/src/kimchi.main.js | 11 +-- ui/pages/help/Makefile.am | 16 ++--- ui/pages/help/dita-help.xsl | 4 +- ui/pages/help/en_US/Makefile.am | 23 +++++++ ui/pages/help/en_US/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/en_US/host.dita | 70 +++++++++++++++++++ ui/pages/help/en_US/network.dita | 68 ++++++++++++++++++ ui/pages/help/en_US/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/en_US/templates.dita | 122 ++++++++++++++++++++++++++++++++ ui/pages/help/guests.dita | 134 ------------------------------------ ui/pages/help/host.dita | 70 ------------------- ui/pages/help/network.dita | 68 ------------------ ui/pages/help/pt_BR/Makefile.am | 23 +++++++ ui/pages/help/pt_BR/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/pt_BR/host.dita | 70 +++++++++++++++++++ ui/pages/help/pt_BR/network.dita | 68 ++++++++++++++++++ ui/pages/help/pt_BR/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/pt_BR/templates.dita | 122 ++++++++++++++++++++++++++++++++ ui/pages/help/storage.dita | 98 -------------------------- ui/pages/help/templates.dita | 122 -------------------------------- ui/pages/help/zh_CN/Makefile.am | 23 +++++++ ui/pages/help/zh_CN/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/zh_CN/host.dita | 70 +++++++++++++++++++ ui/pages/help/zh_CN/network.dita | 68 ++++++++++++++++++ ui/pages/help/zh_CN/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/zh_CN/templates.dita | 122 ++++++++++++++++++++++++++++++++ 31 files changed, 1567 insertions(+), 511 deletions(-) create mode 100644 ui/pages/help/en_US/Makefile.am create mode 100644 ui/pages/help/en_US/guests.dita create mode 100644 ui/pages/help/en_US/host.dita create mode 100644 ui/pages/help/en_US/network.dita create mode 100644 ui/pages/help/en_US/storage.dita create mode 100644 ui/pages/help/en_US/templates.dita delete mode 100644 ui/pages/help/guests.dita delete mode 100644 ui/pages/help/host.dita delete mode 100644 ui/pages/help/network.dita create mode 100644 ui/pages/help/pt_BR/Makefile.am create mode 100644 ui/pages/help/pt_BR/guests.dita create mode 100644 ui/pages/help/pt_BR/host.dita create mode 100644 ui/pages/help/pt_BR/network.dita create mode 100644 ui/pages/help/pt_BR/storage.dita create mode 100644 ui/pages/help/pt_BR/templates.dita delete mode 100644 ui/pages/help/storage.dita delete mode 100644 ui/pages/help/templates.dita create mode 100644 ui/pages/help/zh_CN/Makefile.am create mode 100644 ui/pages/help/zh_CN/guests.dita create mode 100644 ui/pages/help/zh_CN/host.dita create mode 100644 ui/pages/help/zh_CN/network.dita create mode 100644 ui/pages/help/zh_CN/storage.dita create mode 100644 ui/pages/help/zh_CN/templates.dita -- 1.7.10.4
From: Aline Manera <alinefm@br.ibm.com> We also need to provide translated help pages so organize them according to languages. This patch does not translate the help pages just replicate the English version to pt_BR and zh_CN directories. Signed-off-by: Aline Manera <alinefm@br.ibm.com> --- ui/pages/help/en_US/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/en_US/host.dita | 70 +++++++++++++++++++ ui/pages/help/en_US/network.dita | 68 ++++++++++++++++++ ui/pages/help/en_US/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/en_US/templates.dita | 122 ++++++++++++++++++++++++++++++++ ui/pages/help/pt_BR/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/pt_BR/host.dita | 70 +++++++++++++++++++ ui/pages/help/pt_BR/network.dita | 68 ++++++++++++++++++ ui/pages/help/pt_BR/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/pt_BR/templates.dita | 122 ++++++++++++++++++++++++++++++++ ui/pages/help/zh_CN/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/zh_CN/host.dita | 70 +++++++++++++++++++ ui/pages/help/zh_CN/network.dita | 68 ++++++++++++++++++ ui/pages/help/zh_CN/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/zh_CN/templates.dita | 122 ++++++++++++++++++++++++++++++++ 15 files changed, 1476 insertions(+) create mode 100644 ui/pages/help/en_US/guests.dita create mode 100644 ui/pages/help/en_US/host.dita create mode 100644 ui/pages/help/en_US/network.dita create mode 100644 ui/pages/help/en_US/storage.dita create mode 100644 ui/pages/help/en_US/templates.dita create mode 100644 ui/pages/help/pt_BR/guests.dita create mode 100644 ui/pages/help/pt_BR/host.dita create mode 100644 ui/pages/help/pt_BR/network.dita create mode 100644 ui/pages/help/pt_BR/storage.dita create mode 100644 ui/pages/help/pt_BR/templates.dita create mode 100644 ui/pages/help/zh_CN/guests.dita create mode 100644 ui/pages/help/zh_CN/host.dita create mode 100644 ui/pages/help/zh_CN/network.dita create mode 100644 ui/pages/help/zh_CN/storage.dita create mode 100644 ui/pages/help/zh_CN/templates.dita diff --git a/ui/pages/help/en_US/guests.dita b/ui/pages/help/en_US/guests.dita new file mode 100644 index 0000000..f6e2c6c --- /dev/null +++ b/ui/pages/help/en_US/guests.dita @@ -0,0 +1,134 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhvirtm" xml:lang="en-us"> +<title>Guests</title> +<shortdesc>The <wintitle>Guests</wintitle> page lists the defined +KVM virtual machines.</shortdesc> +<csbody> +<p>For each guest, the following information is displayed:<dl><dlentry> +<dt>Name</dt> +<dd>Name of the virtual machine.</dd> +</dlentry><dlentry> +<dt>CPU</dt> +<dd>Percentage of processor utilization in the virtual machine.</dd> +</dlentry><dlentry> +<dt>Network I/O</dt> +<dd>Network input/output transmission rate in KB per seconds.</dd> +</dlentry><dlentry> +<dt>Disk I/O</dt> +<dd>Disk input/output transmission rate in KB per seconds.</dd> +</dlentry><dlentry> +<dt>Livetile</dt> +<dd>State of guest operating system console, or an icon that represents +the <tm tmtype="tm" trademark="Linux">Linux</tm> distribution if the +guest is not active.</dd> +</dlentry></dl></p> +<p>The following actions icons are displayed for each guest:<dl> +<dlentry> +<dt>Reset</dt> +<dd>Click to reset the guest. </dd> +</dlentry><dlentry> +<dt>Power (Start or Stop)</dt> +<dd>Click to power on or power off the guest. If the icon is red, +the power is off; if the icon is green, the power is on.</dd> +</dlentry></dl> </p> +<p>The following actions can be selected for each guest:<ul> +<li>Select <uicontrol>Connect</uicontrol> to connect to the remote +console for the guest operating system.</li> +<li>Select <uicontrol>Manage media</uicontrol> to change the path +to the installation media.</li> +<li>Select <uicontrol>Reset</uicontrol> to reset the guest.</li> +<li>Select <uicontrol>Edit</uicontrol> to edit the properties of an +existing guest. Guests can be edited only while stopped.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the guest.</li> +</ul>To create a guest, or virtual machine, click the <uicontrol>plus +(+)</uicontrol> icon in the upper right of the page.</p> +</csbody> +<cshelp id="kimhvirtmcrt" xml:lang="en-us"> +<title>Create virtual machine</title> +<shortdesc>Create a virtual machine by using an existing template.</shortdesc> +<csbody> +<p> <ol> +<li>Type the name to be used to identify the virtual machine.</li> +<li rev="rev1">Select a template. <ul> +<li>If templates exist, select from displayed templates.</li> +<li>If no templates exist, click <uicontrol>Create a template</uicontrol> to +create a template.</li> +</ul></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +<cshelp id="kimhvirtmedit" xml:lang="en-us"> +<title>Edit guest</title> +<shortdesc>Edit the properties of an existing virtual machine. Guests +can be edited only while stopped.</shortdesc> +<csprolog><csmetadata></csmetadata></csprolog> +<csbody> +<p>For each guest, the following information is displayed on the <wintitle>General</wintitle> tab:<dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the virtual machine.</dd> +</dlentry><dlentry> +<dt>CPUs</dt> +<dd>Number of processors.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of memory in MB.</dd> +</dlentry><dlentry> +<dt>Icon</dt> +<dd>Graphic image representing the Linux distribution to be displayed +in place of current status (Livetile) when the guest is not active.</dd> +</dlentry></dl></p> +<p>The following information is displayed on the <wintitle>Storage</wintitle> tab.</p> +<dl><dlentry> +<dt>Storage</dt> +<dd>Displays the location of the ISO file used for installation.</dd> +</dlentry></dl><?Pub Caret -2?> +<p> Fields that are not disabled can be edited. After you edit a field, +click <uicontrol>Save</uicontrol>. </p> +</csbody> +</cshelp> +<cshelp id="kimstoragedevice" xml:lang="en-us"> +<title>Add, replace, or detach a storage device</title> +<shortdesc rev="rev1">You can add, replace, or detach a storage device +to your virtual machine. The only supported device is CDROM. To edit +your storage devices, follow these steps:</shortdesc> +<csbody> +<ol> +<li>On the <wintitle>Edit Guest</wintitle> window, select <wintitle>Storage</wintitle>.</li> +<li>To replace a storage device, click the first icon with the <uicontrol>orange +slash (/)</uicontrol>. Enter the ISO file path and click <uicontrol>Replace</uicontrol>.</li> +<li>To detach a storage device, click the second icon with the <uicontrol>red +dash (-)</uicontrol>. Confirm the deletion and click <uicontrol>OK</uicontrol>.</li> +<li>To add a storage device, click the third icon with the green <uicontrol>plus +sign (+)</uicontrol>. Enter a device name and ISO file path and click <uicontrol>Attach</uicontrol>.</li> +</ol> +</csbody> +</cshelp> +<cshelp id="kimreplacemedia" xml:lang="en-us"> +<title>Replace a CDROM of VM</title> +<shortdesc rev="rev1">You can replace the contents of the CDROM for +a virtual machine after the installation is complete.</shortdesc> +<csbody> +<ol> +<li>Ensure that the virtual machine is started.</li> +<li>From the Actions menu, select <uicontrol>Manage Media</uicontrol>.</li> +<li>To change what is currently loaded in the CDROM, click the <uicontrol>orange +slash (/)</uicontrol> icon next to the hdc field.</li> +<li>On the <wintitle>Replace a CDROM of VM</wintitle> page, enter +the ISO file path. The other two fields are read-only.</li> +<li>Click <uicontrol>Replace</uicontrol>.</li> +</ol> +</csbody> +</cshelp> +<?tm 1391540919 3?> +</cshelp> +<?Pub *0000005541?> diff --git a/ui/pages/help/en_US/host.dita b/ui/pages/help/en_US/host.dita new file mode 100644 index 0000000..335c51c --- /dev/null +++ b/ui/pages/help/en_US/host.dita @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhhost" xml:lang="en-us"> +<title>Host</title> +<shortdesc>The <wintitle>Host</wintitle> page shows information about +the host system, and allows you to shut down, restart, and connect +to the host.</shortdesc> +<csbody> +<p>You can perform the following actions on the host:<ul> +<li>Select <uicontrol>Shut down</uicontrol> to shut down the host +system.</li> +<li>Select <uicontrol>Restart</uicontrol> to restart the host system.</li> +<li>Select <uicontrol>Connect</uicontrol> to open a VNC connection +to the host system, if it is not already connected.</li> +</ul></p> +<p>Click the following sections to display information about the host:<dl> +<dlentry> +<dt>Basic information</dt> +<dd>This section displays the host operating system distribution, +version, and code name, as well as the processor type and amount of +memory in GB.</dd> +</dlentry><dlentry> +<dt>System statistics</dt> +<dd>This section displays graphs to show statistics for CPU, memory, +disk I/O, and network I/O for the host. Select <uicontrol>Collecting +data after leaving this page</uicontrol> to continue collecting data +when the host tab is out of view.</dd> +</dlentry><dlentry> +<dt>Software Updates</dt> +<dd>This section displays information for all of the packages that +have updates available, including package name, version, architecture, +and repository. You can update all of the packages listed by selecting <uicontrol>Update +All</uicontrol>. You cannot select individual packages for updates.</dd> +</dlentry><dlentry> +<dt>Repositories</dt> +<dd>This section displays repositories that are associated with the +host system. You can add, enable, edit, or remove repositories. Adding +a repository associates it with the host system while enabling a repository +allows the host to access it. If your system is Red Hat Enterprise +Linux or Fedora, you can add <filepath>yum</filepath> repositories. +If your system is Ubuntu or Debian, then add <filepath>deb</filepath> repositories.<p>If +you are working with yum repositories, you can add a GPG check to +verify that a package from this repository have not been corrupted. +Select a repository and then <uicontrol>Edit</uicontrol>. Select <uicontrol>Yes</uicontrol> to +enable GPG Check and then enter a URL to the GPG key file for the +repository.</p><?Pub Caret 156?></dd> +</dlentry><dlentry> +<dt>Debug reports</dt> +<dd>This section displays debug reports, including name and file path. +You can select from options to generate a new report, or rename, remove, +or download an existing report.<p>The debug report is generated using +the <cmdname>sosreport</cmdname> command. It is available for Red +Hat Enterprise <tm tmtype="tm" trademark="Linux">Linux</tm>, Fedora, +and Ubuntu distributions. The command generates a .tar file that contains +configuration and diagnostic information, such as the running kernel +version, loaded modules, and system and service configuration files. +The command also runs external programs to collect further information +and stores this output in the resulting archive.</p> </dd> +</dlentry></dl></p> +</csbody> +<?tm 1392659967 1?> +</cshelp> +<?Pub *0000003492?> diff --git a/ui/pages/help/en_US/network.dita b/ui/pages/help/en_US/network.dita new file mode 100644 index 0000000..25c05ff --- /dev/null +++ b/ui/pages/help/en_US/network.dita @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhnetw" xml:lang="en-us"> +<title>Network</title> +<shortdesc>The <wintitle>Network</wintitle> page displays information +about the network connection.</shortdesc> +<csbody> +<p><dl><dlentry> +<dt>Network Name</dt> +<dd>Name of the network, or <uicontrol>default</uicontrol>.</dd> +</dlentry><dlentry> +<dt>State</dt> +<dd>State of the network, active (green) or inactive (red). </dd> +</dlentry><dlentry> +<dt>Network type</dt> +<dd>Network type, for example, <uicontrol>NAT</uicontrol> (network +address translation).</dd> +</dlentry><dlentry> +<dt>Interface</dt> +<dd>Network interface, for example, <uicontrol>virbr0</uicontrol> (default).</dd> +</dlentry><dlentry> +<dt>Address space</dt> +<dd>IP address.</dd> +</dlentry></dl></p> +<p>The following actions can be selected:<ul> +<li rev="rev1">Select <uicontrol>Start</uicontrol> to begin the network +connection.</li> +<li>Select <uicontrol>Stop</uicontrol> to end the network connection.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the connection +information.</li> +</ul>To create a network, click the <uicontrol>plus (+)</uicontrol> icon +in the upper right of the display.</p> +</csbody> +<cshelp id="kimhnetwcrt" xml:lang="en-us"> +<title>Create a network</title> +<shortdesc>Create a network.</shortdesc> +<csbody> +<p> <ol> +<li>Type the name of the network.</li> +<li>Click to select the network type. <dl rev="rev1"><dlentry> +<dt><uicontrol>Isolated</uicontrol></dt> +<dd>Isolated mode. Guests cannot send or receive communication to +or from external systems.</dd> +</dlentry><dlentry> +<dt><uicontrol>NAT</uicontrol></dt> +<dd>Network Address Translation mode. Communication from guests to +external systems uses the host IP address. External systems cannot +initiate communication to guests.</dd> +</dlentry><dlentry> +<dt><uicontrol>Bridged</uicontrol></dt> +<dd>Bridged mode. Guests can communicate with external systems and +be contacted by external systems as if they were physical systems +on the network. For bridged mode, you must specify additional destination +and VLAN information.</dd> +</dlentry></dl><?Pub Caret 224?></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000002571?> diff --git a/ui/pages/help/en_US/storage.dita b/ui/pages/help/en_US/storage.dita new file mode 100644 index 0000000..12ce15c --- /dev/null +++ b/ui/pages/help/en_US/storage.dita @@ -0,0 +1,98 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhstor" xml:lang="en-us"> +<title>Storage</title> +<shortdesc>The <wintitle>Storage</wintitle> page lists the available +storage pools, including the default storage pool.</shortdesc> +<csbody> +<p>For each storage pool, the following information is displayed:<dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the storage pool and percentage used.</dd> +</dlentry><dlentry> +<dt>State</dt> +<dd>State of the storage pool, active (green) or inactive (red). </dd> +</dlentry><dlentry> +<dt>Location</dt> +<dd>File path to the location of the storage pool.</dd> +</dlentry><dlentry> +<dt>Type</dt> +<dd>Type of storage pool, for example, <uicontrol>dir</uicontrol>.</dd> +</dlentry><dlentry> +<dt>Capacity</dt> +<dd>Amount of space in the storage pool.</dd> +</dlentry><dlentry> +<dt>Allocated</dt> +<dd>Amount of space that is already allocated in the storage pool.</dd> +</dlentry></dl></p> +<p>The following actions can be selected for each storage pool:<ul> +<li>Select <uicontrol>Activate</uicontrol> to activate the storage +pool so that it can be used.</li> +<li>Select <uicontrol>Deactivate</uicontrol> to deactivate an active +storage pool.</li> +<li>Select <uicontrol>Undefine</uicontrol> to remove an inactive storage +pool.</li> +</ul></p> +<p>To display storage volume details for a storage pool, click the +arrow on the right side of the storage pool row. Details include +the following:<dl><dlentry> +<dt>Type</dt> +<dd>The type of volume, for example, <uicontrol>file</uicontrol>.</dd> +</dlentry><dlentry> +<dt>Format</dt> +<dd>The format, varying dependent on the type.</dd> +</dlentry><dlentry> +<dt>Capacity</dt> +<dd>Size of the storage volume.</dd> +</dlentry><dlentry> +<dt>Allocation</dt> +<dd>Amount of space that is already allocated in the storage pool.</dd> +</dlentry></dl>To define a storage pool, click the <uicontrol>plus +(+)</uicontrol> icon in the upper right of the display.</p> +</csbody> +<cshelp id="kimhdefstor" xml:lang="en-us"> +<title>Define a storage pool</title> +<shortdesc> Define a storage pool.</shortdesc> +<csbody> +<p> <ol> +<li>In the <uicontrol>Storage pool name</uicontrol> field, type the +name to be used to identify the storage pool.</li> +<li>In the <uicontrol>Storage pool type</uicontrol> list, select the +type: <dl><dlentry> +<dt><uicontrol>DIR</uicontrol></dt> +<dd>Specifies a directory pool. When selecting <uicontrol>DIR</uicontrol>, +type the <uicontrol>Storage path</uicontrol> (file path to the storage +pool).</dd> +</dlentry><dlentry> +<dt><uicontrol>NFS</uicontrol></dt> +<dd>Specifies a network filesystem pool. When selecting <uicontrol>NFS</uicontrol>, +type the <uicontrol>NFS server IP</uicontrol> address and <uicontrol>NFS +path</uicontrol> (path of the exported directory).</dd> +</dlentry><dlentry> +<dt><uicontrol>iSCSI</uicontrol></dt> +<dd>Specifies a pool based on a target allocated on an iSCSI server. +When selecting <uicontrol>iSCSI</uicontrol>, type the <uicontrol>iSCSI +server</uicontrol> IP address and <uicontrol>Target</uicontrol> on +the iSCSI server. You can optionally select to add iSCSI authentication.</dd> +</dlentry><dlentry> +<dt><uicontrol>Logical</uicontrol></dt> +<dd>Specifies a logical volume storage pool. Select the location to +the device in <uicontrol>Device path</uicontrol>.</dd> +</dlentry><dlentry> +<dt><uicontrol>SCSI Fibre Channel</uicontrol></dt> +<dd>Specifies a pool based on an SCSI Fibre Channel. Select which +SCSI adapter to use.</dd> +</dlentry></dl><?Pub Caret 0?></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000003914?> diff --git a/ui/pages/help/en_US/templates.dita b/ui/pages/help/en_US/templates.dita new file mode 100644 index 0000000..aee0726 --- /dev/null +++ b/ui/pages/help/en_US/templates.dita @@ -0,0 +1,122 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhtempl" xml:lang="en-us"> +<title>Templates</title> +<shortdesc>The <wintitle>Templates</wintitle> page shows the defined +virtual machine templates that can be used to create KVM guests.</shortdesc> +<csbody> +<p>For each template, the following information is displayed:<dl> +<dlentry> +<dt>OS</dt> +<dd>Name of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>Version of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>CPUs</dt> +<dd>Number of processors that are defined for the template.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of random access memory to be allocated, in MB.</dd> +</dlentry></dl></p> +<p>The following actions can be selected for each template:<ul> +<li>Select <uicontrol>Edit</uicontrol> to edit the template.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the template.</li> +</ul>To add a template, click the <uicontrol>plus (+)</uicontrol> icon +in the upper right of the display.</p> +</csbody> +<cshelp id="kimhedittempl" xml:lang="en-us"> +<title>Edit template</title> +<shortdesc>Edit an existing template.</shortdesc> +<csbody> +<p>For each template, the following information is displayed: <dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the template.</dd> +</dlentry><dlentry> +<dt>Vendor</dt> +<dd>The name of the company that created the operating system or distribution +that the template is configured to use.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>The version of the operating system or distribution that the template +is configured to use.</dd> +</dlentry><dlentry> +<dt>CPU number</dt> +<dd>Number of processors that are defined for the template.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of memory in MB to be allocated to the virtual machine.</dd> +</dlentry><dlentry> +<dt>Disk</dt> +<dd>Disk size in GB.</dd> +</dlentry><dlentry> +<dt>CDROM</dt> +<dd>File path to the location of the ISO file used to install the +KVM guest.</dd> +</dlentry><dlentry> +<dt>Storage pool</dt> +<dd>Specific storage pool or the default storage pool.</dd> +</dlentry><dlentry> +<dt>Network</dt> +<dd>Default network interfaces available to the KVM guest. You can +select multiple networks.</dd> +</dlentry></dl> Fields that are not disabled can be edited. After +you edit a field, click <uicontrol>Save</uicontrol>. </p> +</csbody> +</cshelp> +<cshelp id="kimhaddtempl"> +<title>Add template</title> +<shortdesc>Add a template from source media.</shortdesc> +<csbody> +<p>Select the location of the source media from the following options:<dl> +<dlentry> +<dt>Local ISO image</dt> +<dd>Select to scan storage pools for installation ISO images available +on the system.</dd> +</dlentry><dlentry> +<dt>Remote ISO image</dt> +<dd>Select to specify a remote location for an installation ISO image.</dd> +</dlentry></dl></p> +</csbody> +</cshelp> +<cshelp id="kimhaddloct"> +<title>Add template - local ISO image</title> +<shortdesc>Add a template from a local ISO image.</shortdesc> +<csbody> +<p>The ISO images available on the system are displayed.<dl><dlentry> +<dt>OS</dt> +<dd>Name of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>Version of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Size</dt> +<dd>Size of the ISO image.</dd> +</dlentry></dl></p> +<p>To create a template from an ISO image, choose from the following +options:<ul> +<li>Select an ISO image from which to create a template, then click <uicontrol>Create +Templates from Selected ISO</uicontrol>.</li> +<li>Select <uicontrol>All</uicontrol> to create a template from each + listed ISO image, then click <uicontrol>Create Templates from Selected +ISO</uicontrol>.</li> +<li>If the ISO image that you want to use does not appear in the scan +results, you can select from the following options:<ul> +<li>Select <uicontrol>I want to use a specific ISO file</uicontrol> to +specify a path to the ISO image.</li> +<li>Click <uicontrol>Search more ISOs</uicontrol> to search for more +ISO images.</li> +</ul></li><?Pub Caret 0?> +</ul></p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000004433?> diff --git a/ui/pages/help/pt_BR/guests.dita b/ui/pages/help/pt_BR/guests.dita new file mode 100644 index 0000000..f6e2c6c --- /dev/null +++ b/ui/pages/help/pt_BR/guests.dita @@ -0,0 +1,134 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhvirtm" xml:lang="en-us"> +<title>Guests</title> +<shortdesc>The <wintitle>Guests</wintitle> page lists the defined +KVM virtual machines.</shortdesc> +<csbody> +<p>For each guest, the following information is displayed:<dl><dlentry> +<dt>Name</dt> +<dd>Name of the virtual machine.</dd> +</dlentry><dlentry> +<dt>CPU</dt> +<dd>Percentage of processor utilization in the virtual machine.</dd> +</dlentry><dlentry> +<dt>Network I/O</dt> +<dd>Network input/output transmission rate in KB per seconds.</dd> +</dlentry><dlentry> +<dt>Disk I/O</dt> +<dd>Disk input/output transmission rate in KB per seconds.</dd> +</dlentry><dlentry> +<dt>Livetile</dt> +<dd>State of guest operating system console, or an icon that represents +the <tm tmtype="tm" trademark="Linux">Linux</tm> distribution if the +guest is not active.</dd> +</dlentry></dl></p> +<p>The following actions icons are displayed for each guest:<dl> +<dlentry> +<dt>Reset</dt> +<dd>Click to reset the guest. </dd> +</dlentry><dlentry> +<dt>Power (Start or Stop)</dt> +<dd>Click to power on or power off the guest. If the icon is red, +the power is off; if the icon is green, the power is on.</dd> +</dlentry></dl> </p> +<p>The following actions can be selected for each guest:<ul> +<li>Select <uicontrol>Connect</uicontrol> to connect to the remote +console for the guest operating system.</li> +<li>Select <uicontrol>Manage media</uicontrol> to change the path +to the installation media.</li> +<li>Select <uicontrol>Reset</uicontrol> to reset the guest.</li> +<li>Select <uicontrol>Edit</uicontrol> to edit the properties of an +existing guest. Guests can be edited only while stopped.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the guest.</li> +</ul>To create a guest, or virtual machine, click the <uicontrol>plus +(+)</uicontrol> icon in the upper right of the page.</p> +</csbody> +<cshelp id="kimhvirtmcrt" xml:lang="en-us"> +<title>Create virtual machine</title> +<shortdesc>Create a virtual machine by using an existing template.</shortdesc> +<csbody> +<p> <ol> +<li>Type the name to be used to identify the virtual machine.</li> +<li rev="rev1">Select a template. <ul> +<li>If templates exist, select from displayed templates.</li> +<li>If no templates exist, click <uicontrol>Create a template</uicontrol> to +create a template.</li> +</ul></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +<cshelp id="kimhvirtmedit" xml:lang="en-us"> +<title>Edit guest</title> +<shortdesc>Edit the properties of an existing virtual machine. Guests +can be edited only while stopped.</shortdesc> +<csprolog><csmetadata></csmetadata></csprolog> +<csbody> +<p>For each guest, the following information is displayed on the <wintitle>General</wintitle> tab:<dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the virtual machine.</dd> +</dlentry><dlentry> +<dt>CPUs</dt> +<dd>Number of processors.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of memory in MB.</dd> +</dlentry><dlentry> +<dt>Icon</dt> +<dd>Graphic image representing the Linux distribution to be displayed +in place of current status (Livetile) when the guest is not active.</dd> +</dlentry></dl></p> +<p>The following information is displayed on the <wintitle>Storage</wintitle> tab.</p> +<dl><dlentry> +<dt>Storage</dt> +<dd>Displays the location of the ISO file used for installation.</dd> +</dlentry></dl><?Pub Caret -2?> +<p> Fields that are not disabled can be edited. After you edit a field, +click <uicontrol>Save</uicontrol>. </p> +</csbody> +</cshelp> +<cshelp id="kimstoragedevice" xml:lang="en-us"> +<title>Add, replace, or detach a storage device</title> +<shortdesc rev="rev1">You can add, replace, or detach a storage device +to your virtual machine. The only supported device is CDROM. To edit +your storage devices, follow these steps:</shortdesc> +<csbody> +<ol> +<li>On the <wintitle>Edit Guest</wintitle> window, select <wintitle>Storage</wintitle>.</li> +<li>To replace a storage device, click the first icon with the <uicontrol>orange +slash (/)</uicontrol>. Enter the ISO file path and click <uicontrol>Replace</uicontrol>.</li> +<li>To detach a storage device, click the second icon with the <uicontrol>red +dash (-)</uicontrol>. Confirm the deletion and click <uicontrol>OK</uicontrol>.</li> +<li>To add a storage device, click the third icon with the green <uicontrol>plus +sign (+)</uicontrol>. Enter a device name and ISO file path and click <uicontrol>Attach</uicontrol>.</li> +</ol> +</csbody> +</cshelp> +<cshelp id="kimreplacemedia" xml:lang="en-us"> +<title>Replace a CDROM of VM</title> +<shortdesc rev="rev1">You can replace the contents of the CDROM for +a virtual machine after the installation is complete.</shortdesc> +<csbody> +<ol> +<li>Ensure that the virtual machine is started.</li> +<li>From the Actions menu, select <uicontrol>Manage Media</uicontrol>.</li> +<li>To change what is currently loaded in the CDROM, click the <uicontrol>orange +slash (/)</uicontrol> icon next to the hdc field.</li> +<li>On the <wintitle>Replace a CDROM of VM</wintitle> page, enter +the ISO file path. The other two fields are read-only.</li> +<li>Click <uicontrol>Replace</uicontrol>.</li> +</ol> +</csbody> +</cshelp> +<?tm 1391540919 3?> +</cshelp> +<?Pub *0000005541?> diff --git a/ui/pages/help/pt_BR/host.dita b/ui/pages/help/pt_BR/host.dita new file mode 100644 index 0000000..335c51c --- /dev/null +++ b/ui/pages/help/pt_BR/host.dita @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhhost" xml:lang="en-us"> +<title>Host</title> +<shortdesc>The <wintitle>Host</wintitle> page shows information about +the host system, and allows you to shut down, restart, and connect +to the host.</shortdesc> +<csbody> +<p>You can perform the following actions on the host:<ul> +<li>Select <uicontrol>Shut down</uicontrol> to shut down the host +system.</li> +<li>Select <uicontrol>Restart</uicontrol> to restart the host system.</li> +<li>Select <uicontrol>Connect</uicontrol> to open a VNC connection +to the host system, if it is not already connected.</li> +</ul></p> +<p>Click the following sections to display information about the host:<dl> +<dlentry> +<dt>Basic information</dt> +<dd>This section displays the host operating system distribution, +version, and code name, as well as the processor type and amount of +memory in GB.</dd> +</dlentry><dlentry> +<dt>System statistics</dt> +<dd>This section displays graphs to show statistics for CPU, memory, +disk I/O, and network I/O for the host. Select <uicontrol>Collecting +data after leaving this page</uicontrol> to continue collecting data +when the host tab is out of view.</dd> +</dlentry><dlentry> +<dt>Software Updates</dt> +<dd>This section displays information for all of the packages that +have updates available, including package name, version, architecture, +and repository. You can update all of the packages listed by selecting <uicontrol>Update +All</uicontrol>. You cannot select individual packages for updates.</dd> +</dlentry><dlentry> +<dt>Repositories</dt> +<dd>This section displays repositories that are associated with the +host system. You can add, enable, edit, or remove repositories. Adding +a repository associates it with the host system while enabling a repository +allows the host to access it. If your system is Red Hat Enterprise +Linux or Fedora, you can add <filepath>yum</filepath> repositories. +If your system is Ubuntu or Debian, then add <filepath>deb</filepath> repositories.<p>If +you are working with yum repositories, you can add a GPG check to +verify that a package from this repository have not been corrupted. +Select a repository and then <uicontrol>Edit</uicontrol>. Select <uicontrol>Yes</uicontrol> to +enable GPG Check and then enter a URL to the GPG key file for the +repository.</p><?Pub Caret 156?></dd> +</dlentry><dlentry> +<dt>Debug reports</dt> +<dd>This section displays debug reports, including name and file path. +You can select from options to generate a new report, or rename, remove, +or download an existing report.<p>The debug report is generated using +the <cmdname>sosreport</cmdname> command. It is available for Red +Hat Enterprise <tm tmtype="tm" trademark="Linux">Linux</tm>, Fedora, +and Ubuntu distributions. The command generates a .tar file that contains +configuration and diagnostic information, such as the running kernel +version, loaded modules, and system and service configuration files. +The command also runs external programs to collect further information +and stores this output in the resulting archive.</p> </dd> +</dlentry></dl></p> +</csbody> +<?tm 1392659967 1?> +</cshelp> +<?Pub *0000003492?> diff --git a/ui/pages/help/pt_BR/network.dita b/ui/pages/help/pt_BR/network.dita new file mode 100644 index 0000000..25c05ff --- /dev/null +++ b/ui/pages/help/pt_BR/network.dita @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhnetw" xml:lang="en-us"> +<title>Network</title> +<shortdesc>The <wintitle>Network</wintitle> page displays information +about the network connection.</shortdesc> +<csbody> +<p><dl><dlentry> +<dt>Network Name</dt> +<dd>Name of the network, or <uicontrol>default</uicontrol>.</dd> +</dlentry><dlentry> +<dt>State</dt> +<dd>State of the network, active (green) or inactive (red). </dd> +</dlentry><dlentry> +<dt>Network type</dt> +<dd>Network type, for example, <uicontrol>NAT</uicontrol> (network +address translation).</dd> +</dlentry><dlentry> +<dt>Interface</dt> +<dd>Network interface, for example, <uicontrol>virbr0</uicontrol> (default).</dd> +</dlentry><dlentry> +<dt>Address space</dt> +<dd>IP address.</dd> +</dlentry></dl></p> +<p>The following actions can be selected:<ul> +<li rev="rev1">Select <uicontrol>Start</uicontrol> to begin the network +connection.</li> +<li>Select <uicontrol>Stop</uicontrol> to end the network connection.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the connection +information.</li> +</ul>To create a network, click the <uicontrol>plus (+)</uicontrol> icon +in the upper right of the display.</p> +</csbody> +<cshelp id="kimhnetwcrt" xml:lang="en-us"> +<title>Create a network</title> +<shortdesc>Create a network.</shortdesc> +<csbody> +<p> <ol> +<li>Type the name of the network.</li> +<li>Click to select the network type. <dl rev="rev1"><dlentry> +<dt><uicontrol>Isolated</uicontrol></dt> +<dd>Isolated mode. Guests cannot send or receive communication to +or from external systems.</dd> +</dlentry><dlentry> +<dt><uicontrol>NAT</uicontrol></dt> +<dd>Network Address Translation mode. Communication from guests to +external systems uses the host IP address. External systems cannot +initiate communication to guests.</dd> +</dlentry><dlentry> +<dt><uicontrol>Bridged</uicontrol></dt> +<dd>Bridged mode. Guests can communicate with external systems and +be contacted by external systems as if they were physical systems +on the network. For bridged mode, you must specify additional destination +and VLAN information.</dd> +</dlentry></dl><?Pub Caret 224?></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000002571?> diff --git a/ui/pages/help/pt_BR/storage.dita b/ui/pages/help/pt_BR/storage.dita new file mode 100644 index 0000000..12ce15c --- /dev/null +++ b/ui/pages/help/pt_BR/storage.dita @@ -0,0 +1,98 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhstor" xml:lang="en-us"> +<title>Storage</title> +<shortdesc>The <wintitle>Storage</wintitle> page lists the available +storage pools, including the default storage pool.</shortdesc> +<csbody> +<p>For each storage pool, the following information is displayed:<dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the storage pool and percentage used.</dd> +</dlentry><dlentry> +<dt>State</dt> +<dd>State of the storage pool, active (green) or inactive (red). </dd> +</dlentry><dlentry> +<dt>Location</dt> +<dd>File path to the location of the storage pool.</dd> +</dlentry><dlentry> +<dt>Type</dt> +<dd>Type of storage pool, for example, <uicontrol>dir</uicontrol>.</dd> +</dlentry><dlentry> +<dt>Capacity</dt> +<dd>Amount of space in the storage pool.</dd> +</dlentry><dlentry> +<dt>Allocated</dt> +<dd>Amount of space that is already allocated in the storage pool.</dd> +</dlentry></dl></p> +<p>The following actions can be selected for each storage pool:<ul> +<li>Select <uicontrol>Activate</uicontrol> to activate the storage +pool so that it can be used.</li> +<li>Select <uicontrol>Deactivate</uicontrol> to deactivate an active +storage pool.</li> +<li>Select <uicontrol>Undefine</uicontrol> to remove an inactive storage +pool.</li> +</ul></p> +<p>To display storage volume details for a storage pool, click the +arrow on the right side of the storage pool row. Details include +the following:<dl><dlentry> +<dt>Type</dt> +<dd>The type of volume, for example, <uicontrol>file</uicontrol>.</dd> +</dlentry><dlentry> +<dt>Format</dt> +<dd>The format, varying dependent on the type.</dd> +</dlentry><dlentry> +<dt>Capacity</dt> +<dd>Size of the storage volume.</dd> +</dlentry><dlentry> +<dt>Allocation</dt> +<dd>Amount of space that is already allocated in the storage pool.</dd> +</dlentry></dl>To define a storage pool, click the <uicontrol>plus +(+)</uicontrol> icon in the upper right of the display.</p> +</csbody> +<cshelp id="kimhdefstor" xml:lang="en-us"> +<title>Define a storage pool</title> +<shortdesc> Define a storage pool.</shortdesc> +<csbody> +<p> <ol> +<li>In the <uicontrol>Storage pool name</uicontrol> field, type the +name to be used to identify the storage pool.</li> +<li>In the <uicontrol>Storage pool type</uicontrol> list, select the +type: <dl><dlentry> +<dt><uicontrol>DIR</uicontrol></dt> +<dd>Specifies a directory pool. When selecting <uicontrol>DIR</uicontrol>, +type the <uicontrol>Storage path</uicontrol> (file path to the storage +pool).</dd> +</dlentry><dlentry> +<dt><uicontrol>NFS</uicontrol></dt> +<dd>Specifies a network filesystem pool. When selecting <uicontrol>NFS</uicontrol>, +type the <uicontrol>NFS server IP</uicontrol> address and <uicontrol>NFS +path</uicontrol> (path of the exported directory).</dd> +</dlentry><dlentry> +<dt><uicontrol>iSCSI</uicontrol></dt> +<dd>Specifies a pool based on a target allocated on an iSCSI server. +When selecting <uicontrol>iSCSI</uicontrol>, type the <uicontrol>iSCSI +server</uicontrol> IP address and <uicontrol>Target</uicontrol> on +the iSCSI server. You can optionally select to add iSCSI authentication.</dd> +</dlentry><dlentry> +<dt><uicontrol>Logical</uicontrol></dt> +<dd>Specifies a logical volume storage pool. Select the location to +the device in <uicontrol>Device path</uicontrol>.</dd> +</dlentry><dlentry> +<dt><uicontrol>SCSI Fibre Channel</uicontrol></dt> +<dd>Specifies a pool based on an SCSI Fibre Channel. Select which +SCSI adapter to use.</dd> +</dlentry></dl><?Pub Caret 0?></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000003914?> diff --git a/ui/pages/help/pt_BR/templates.dita b/ui/pages/help/pt_BR/templates.dita new file mode 100644 index 0000000..aee0726 --- /dev/null +++ b/ui/pages/help/pt_BR/templates.dita @@ -0,0 +1,122 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhtempl" xml:lang="en-us"> +<title>Templates</title> +<shortdesc>The <wintitle>Templates</wintitle> page shows the defined +virtual machine templates that can be used to create KVM guests.</shortdesc> +<csbody> +<p>For each template, the following information is displayed:<dl> +<dlentry> +<dt>OS</dt> +<dd>Name of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>Version of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>CPUs</dt> +<dd>Number of processors that are defined for the template.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of random access memory to be allocated, in MB.</dd> +</dlentry></dl></p> +<p>The following actions can be selected for each template:<ul> +<li>Select <uicontrol>Edit</uicontrol> to edit the template.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the template.</li> +</ul>To add a template, click the <uicontrol>plus (+)</uicontrol> icon +in the upper right of the display.</p> +</csbody> +<cshelp id="kimhedittempl" xml:lang="en-us"> +<title>Edit template</title> +<shortdesc>Edit an existing template.</shortdesc> +<csbody> +<p>For each template, the following information is displayed: <dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the template.</dd> +</dlentry><dlentry> +<dt>Vendor</dt> +<dd>The name of the company that created the operating system or distribution +that the template is configured to use.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>The version of the operating system or distribution that the template +is configured to use.</dd> +</dlentry><dlentry> +<dt>CPU number</dt> +<dd>Number of processors that are defined for the template.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of memory in MB to be allocated to the virtual machine.</dd> +</dlentry><dlentry> +<dt>Disk</dt> +<dd>Disk size in GB.</dd> +</dlentry><dlentry> +<dt>CDROM</dt> +<dd>File path to the location of the ISO file used to install the +KVM guest.</dd> +</dlentry><dlentry> +<dt>Storage pool</dt> +<dd>Specific storage pool or the default storage pool.</dd> +</dlentry><dlentry> +<dt>Network</dt> +<dd>Default network interfaces available to the KVM guest. You can +select multiple networks.</dd> +</dlentry></dl> Fields that are not disabled can be edited. After +you edit a field, click <uicontrol>Save</uicontrol>. </p> +</csbody> +</cshelp> +<cshelp id="kimhaddtempl"> +<title>Add template</title> +<shortdesc>Add a template from source media.</shortdesc> +<csbody> +<p>Select the location of the source media from the following options:<dl> +<dlentry> +<dt>Local ISO image</dt> +<dd>Select to scan storage pools for installation ISO images available +on the system.</dd> +</dlentry><dlentry> +<dt>Remote ISO image</dt> +<dd>Select to specify a remote location for an installation ISO image.</dd> +</dlentry></dl></p> +</csbody> +</cshelp> +<cshelp id="kimhaddloct"> +<title>Add template - local ISO image</title> +<shortdesc>Add a template from a local ISO image.</shortdesc> +<csbody> +<p>The ISO images available on the system are displayed.<dl><dlentry> +<dt>OS</dt> +<dd>Name of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>Version of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Size</dt> +<dd>Size of the ISO image.</dd> +</dlentry></dl></p> +<p>To create a template from an ISO image, choose from the following +options:<ul> +<li>Select an ISO image from which to create a template, then click <uicontrol>Create +Templates from Selected ISO</uicontrol>.</li> +<li>Select <uicontrol>All</uicontrol> to create a template from each + listed ISO image, then click <uicontrol>Create Templates from Selected +ISO</uicontrol>.</li> +<li>If the ISO image that you want to use does not appear in the scan +results, you can select from the following options:<ul> +<li>Select <uicontrol>I want to use a specific ISO file</uicontrol> to +specify a path to the ISO image.</li> +<li>Click <uicontrol>Search more ISOs</uicontrol> to search for more +ISO images.</li> +</ul></li><?Pub Caret 0?> +</ul></p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000004433?> diff --git a/ui/pages/help/zh_CN/guests.dita b/ui/pages/help/zh_CN/guests.dita new file mode 100644 index 0000000..f6e2c6c --- /dev/null +++ b/ui/pages/help/zh_CN/guests.dita @@ -0,0 +1,134 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhvirtm" xml:lang="en-us"> +<title>Guests</title> +<shortdesc>The <wintitle>Guests</wintitle> page lists the defined +KVM virtual machines.</shortdesc> +<csbody> +<p>For each guest, the following information is displayed:<dl><dlentry> +<dt>Name</dt> +<dd>Name of the virtual machine.</dd> +</dlentry><dlentry> +<dt>CPU</dt> +<dd>Percentage of processor utilization in the virtual machine.</dd> +</dlentry><dlentry> +<dt>Network I/O</dt> +<dd>Network input/output transmission rate in KB per seconds.</dd> +</dlentry><dlentry> +<dt>Disk I/O</dt> +<dd>Disk input/output transmission rate in KB per seconds.</dd> +</dlentry><dlentry> +<dt>Livetile</dt> +<dd>State of guest operating system console, or an icon that represents +the <tm tmtype="tm" trademark="Linux">Linux</tm> distribution if the +guest is not active.</dd> +</dlentry></dl></p> +<p>The following actions icons are displayed for each guest:<dl> +<dlentry> +<dt>Reset</dt> +<dd>Click to reset the guest. </dd> +</dlentry><dlentry> +<dt>Power (Start or Stop)</dt> +<dd>Click to power on or power off the guest. If the icon is red, +the power is off; if the icon is green, the power is on.</dd> +</dlentry></dl> </p> +<p>The following actions can be selected for each guest:<ul> +<li>Select <uicontrol>Connect</uicontrol> to connect to the remote +console for the guest operating system.</li> +<li>Select <uicontrol>Manage media</uicontrol> to change the path +to the installation media.</li> +<li>Select <uicontrol>Reset</uicontrol> to reset the guest.</li> +<li>Select <uicontrol>Edit</uicontrol> to edit the properties of an +existing guest. Guests can be edited only while stopped.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the guest.</li> +</ul>To create a guest, or virtual machine, click the <uicontrol>plus +(+)</uicontrol> icon in the upper right of the page.</p> +</csbody> +<cshelp id="kimhvirtmcrt" xml:lang="en-us"> +<title>Create virtual machine</title> +<shortdesc>Create a virtual machine by using an existing template.</shortdesc> +<csbody> +<p> <ol> +<li>Type the name to be used to identify the virtual machine.</li> +<li rev="rev1">Select a template. <ul> +<li>If templates exist, select from displayed templates.</li> +<li>If no templates exist, click <uicontrol>Create a template</uicontrol> to +create a template.</li> +</ul></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +<cshelp id="kimhvirtmedit" xml:lang="en-us"> +<title>Edit guest</title> +<shortdesc>Edit the properties of an existing virtual machine. Guests +can be edited only while stopped.</shortdesc> +<csprolog><csmetadata></csmetadata></csprolog> +<csbody> +<p>For each guest, the following information is displayed on the <wintitle>General</wintitle> tab:<dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the virtual machine.</dd> +</dlentry><dlentry> +<dt>CPUs</dt> +<dd>Number of processors.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of memory in MB.</dd> +</dlentry><dlentry> +<dt>Icon</dt> +<dd>Graphic image representing the Linux distribution to be displayed +in place of current status (Livetile) when the guest is not active.</dd> +</dlentry></dl></p> +<p>The following information is displayed on the <wintitle>Storage</wintitle> tab.</p> +<dl><dlentry> +<dt>Storage</dt> +<dd>Displays the location of the ISO file used for installation.</dd> +</dlentry></dl><?Pub Caret -2?> +<p> Fields that are not disabled can be edited. After you edit a field, +click <uicontrol>Save</uicontrol>. </p> +</csbody> +</cshelp> +<cshelp id="kimstoragedevice" xml:lang="en-us"> +<title>Add, replace, or detach a storage device</title> +<shortdesc rev="rev1">You can add, replace, or detach a storage device +to your virtual machine. The only supported device is CDROM. To edit +your storage devices, follow these steps:</shortdesc> +<csbody> +<ol> +<li>On the <wintitle>Edit Guest</wintitle> window, select <wintitle>Storage</wintitle>.</li> +<li>To replace a storage device, click the first icon with the <uicontrol>orange +slash (/)</uicontrol>. Enter the ISO file path and click <uicontrol>Replace</uicontrol>.</li> +<li>To detach a storage device, click the second icon with the <uicontrol>red +dash (-)</uicontrol>. Confirm the deletion and click <uicontrol>OK</uicontrol>.</li> +<li>To add a storage device, click the third icon with the green <uicontrol>plus +sign (+)</uicontrol>. Enter a device name and ISO file path and click <uicontrol>Attach</uicontrol>.</li> +</ol> +</csbody> +</cshelp> +<cshelp id="kimreplacemedia" xml:lang="en-us"> +<title>Replace a CDROM of VM</title> +<shortdesc rev="rev1">You can replace the contents of the CDROM for +a virtual machine after the installation is complete.</shortdesc> +<csbody> +<ol> +<li>Ensure that the virtual machine is started.</li> +<li>From the Actions menu, select <uicontrol>Manage Media</uicontrol>.</li> +<li>To change what is currently loaded in the CDROM, click the <uicontrol>orange +slash (/)</uicontrol> icon next to the hdc field.</li> +<li>On the <wintitle>Replace a CDROM of VM</wintitle> page, enter +the ISO file path. The other two fields are read-only.</li> +<li>Click <uicontrol>Replace</uicontrol>.</li> +</ol> +</csbody> +</cshelp> +<?tm 1391540919 3?> +</cshelp> +<?Pub *0000005541?> diff --git a/ui/pages/help/zh_CN/host.dita b/ui/pages/help/zh_CN/host.dita new file mode 100644 index 0000000..335c51c --- /dev/null +++ b/ui/pages/help/zh_CN/host.dita @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhhost" xml:lang="en-us"> +<title>Host</title> +<shortdesc>The <wintitle>Host</wintitle> page shows information about +the host system, and allows you to shut down, restart, and connect +to the host.</shortdesc> +<csbody> +<p>You can perform the following actions on the host:<ul> +<li>Select <uicontrol>Shut down</uicontrol> to shut down the host +system.</li> +<li>Select <uicontrol>Restart</uicontrol> to restart the host system.</li> +<li>Select <uicontrol>Connect</uicontrol> to open a VNC connection +to the host system, if it is not already connected.</li> +</ul></p> +<p>Click the following sections to display information about the host:<dl> +<dlentry> +<dt>Basic information</dt> +<dd>This section displays the host operating system distribution, +version, and code name, as well as the processor type and amount of +memory in GB.</dd> +</dlentry><dlentry> +<dt>System statistics</dt> +<dd>This section displays graphs to show statistics for CPU, memory, +disk I/O, and network I/O for the host. Select <uicontrol>Collecting +data after leaving this page</uicontrol> to continue collecting data +when the host tab is out of view.</dd> +</dlentry><dlentry> +<dt>Software Updates</dt> +<dd>This section displays information for all of the packages that +have updates available, including package name, version, architecture, +and repository. You can update all of the packages listed by selecting <uicontrol>Update +All</uicontrol>. You cannot select individual packages for updates.</dd> +</dlentry><dlentry> +<dt>Repositories</dt> +<dd>This section displays repositories that are associated with the +host system. You can add, enable, edit, or remove repositories. Adding +a repository associates it with the host system while enabling a repository +allows the host to access it. If your system is Red Hat Enterprise +Linux or Fedora, you can add <filepath>yum</filepath> repositories. +If your system is Ubuntu or Debian, then add <filepath>deb</filepath> repositories.<p>If +you are working with yum repositories, you can add a GPG check to +verify that a package from this repository have not been corrupted. +Select a repository and then <uicontrol>Edit</uicontrol>. Select <uicontrol>Yes</uicontrol> to +enable GPG Check and then enter a URL to the GPG key file for the +repository.</p><?Pub Caret 156?></dd> +</dlentry><dlentry> +<dt>Debug reports</dt> +<dd>This section displays debug reports, including name and file path. +You can select from options to generate a new report, or rename, remove, +or download an existing report.<p>The debug report is generated using +the <cmdname>sosreport</cmdname> command. It is available for Red +Hat Enterprise <tm tmtype="tm" trademark="Linux">Linux</tm>, Fedora, +and Ubuntu distributions. The command generates a .tar file that contains +configuration and diagnostic information, such as the running kernel +version, loaded modules, and system and service configuration files. +The command also runs external programs to collect further information +and stores this output in the resulting archive.</p> </dd> +</dlentry></dl></p> +</csbody> +<?tm 1392659967 1?> +</cshelp> +<?Pub *0000003492?> diff --git a/ui/pages/help/zh_CN/network.dita b/ui/pages/help/zh_CN/network.dita new file mode 100644 index 0000000..25c05ff --- /dev/null +++ b/ui/pages/help/zh_CN/network.dita @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhnetw" xml:lang="en-us"> +<title>Network</title> +<shortdesc>The <wintitle>Network</wintitle> page displays information +about the network connection.</shortdesc> +<csbody> +<p><dl><dlentry> +<dt>Network Name</dt> +<dd>Name of the network, or <uicontrol>default</uicontrol>.</dd> +</dlentry><dlentry> +<dt>State</dt> +<dd>State of the network, active (green) or inactive (red). </dd> +</dlentry><dlentry> +<dt>Network type</dt> +<dd>Network type, for example, <uicontrol>NAT</uicontrol> (network +address translation).</dd> +</dlentry><dlentry> +<dt>Interface</dt> +<dd>Network interface, for example, <uicontrol>virbr0</uicontrol> (default).</dd> +</dlentry><dlentry> +<dt>Address space</dt> +<dd>IP address.</dd> +</dlentry></dl></p> +<p>The following actions can be selected:<ul> +<li rev="rev1">Select <uicontrol>Start</uicontrol> to begin the network +connection.</li> +<li>Select <uicontrol>Stop</uicontrol> to end the network connection.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the connection +information.</li> +</ul>To create a network, click the <uicontrol>plus (+)</uicontrol> icon +in the upper right of the display.</p> +</csbody> +<cshelp id="kimhnetwcrt" xml:lang="en-us"> +<title>Create a network</title> +<shortdesc>Create a network.</shortdesc> +<csbody> +<p> <ol> +<li>Type the name of the network.</li> +<li>Click to select the network type. <dl rev="rev1"><dlentry> +<dt><uicontrol>Isolated</uicontrol></dt> +<dd>Isolated mode. Guests cannot send or receive communication to +or from external systems.</dd> +</dlentry><dlentry> +<dt><uicontrol>NAT</uicontrol></dt> +<dd>Network Address Translation mode. Communication from guests to +external systems uses the host IP address. External systems cannot +initiate communication to guests.</dd> +</dlentry><dlentry> +<dt><uicontrol>Bridged</uicontrol></dt> +<dd>Bridged mode. Guests can communicate with external systems and +be contacted by external systems as if they were physical systems +on the network. For bridged mode, you must specify additional destination +and VLAN information.</dd> +</dlentry></dl><?Pub Caret 224?></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000002571?> diff --git a/ui/pages/help/zh_CN/storage.dita b/ui/pages/help/zh_CN/storage.dita new file mode 100644 index 0000000..12ce15c --- /dev/null +++ b/ui/pages/help/zh_CN/storage.dita @@ -0,0 +1,98 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhstor" xml:lang="en-us"> +<title>Storage</title> +<shortdesc>The <wintitle>Storage</wintitle> page lists the available +storage pools, including the default storage pool.</shortdesc> +<csbody> +<p>For each storage pool, the following information is displayed:<dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the storage pool and percentage used.</dd> +</dlentry><dlentry> +<dt>State</dt> +<dd>State of the storage pool, active (green) or inactive (red). </dd> +</dlentry><dlentry> +<dt>Location</dt> +<dd>File path to the location of the storage pool.</dd> +</dlentry><dlentry> +<dt>Type</dt> +<dd>Type of storage pool, for example, <uicontrol>dir</uicontrol>.</dd> +</dlentry><dlentry> +<dt>Capacity</dt> +<dd>Amount of space in the storage pool.</dd> +</dlentry><dlentry> +<dt>Allocated</dt> +<dd>Amount of space that is already allocated in the storage pool.</dd> +</dlentry></dl></p> +<p>The following actions can be selected for each storage pool:<ul> +<li>Select <uicontrol>Activate</uicontrol> to activate the storage +pool so that it can be used.</li> +<li>Select <uicontrol>Deactivate</uicontrol> to deactivate an active +storage pool.</li> +<li>Select <uicontrol>Undefine</uicontrol> to remove an inactive storage +pool.</li> +</ul></p> +<p>To display storage volume details for a storage pool, click the +arrow on the right side of the storage pool row. Details include +the following:<dl><dlentry> +<dt>Type</dt> +<dd>The type of volume, for example, <uicontrol>file</uicontrol>.</dd> +</dlentry><dlentry> +<dt>Format</dt> +<dd>The format, varying dependent on the type.</dd> +</dlentry><dlentry> +<dt>Capacity</dt> +<dd>Size of the storage volume.</dd> +</dlentry><dlentry> +<dt>Allocation</dt> +<dd>Amount of space that is already allocated in the storage pool.</dd> +</dlentry></dl>To define a storage pool, click the <uicontrol>plus +(+)</uicontrol> icon in the upper right of the display.</p> +</csbody> +<cshelp id="kimhdefstor" xml:lang="en-us"> +<title>Define a storage pool</title> +<shortdesc> Define a storage pool.</shortdesc> +<csbody> +<p> <ol> +<li>In the <uicontrol>Storage pool name</uicontrol> field, type the +name to be used to identify the storage pool.</li> +<li>In the <uicontrol>Storage pool type</uicontrol> list, select the +type: <dl><dlentry> +<dt><uicontrol>DIR</uicontrol></dt> +<dd>Specifies a directory pool. When selecting <uicontrol>DIR</uicontrol>, +type the <uicontrol>Storage path</uicontrol> (file path to the storage +pool).</dd> +</dlentry><dlentry> +<dt><uicontrol>NFS</uicontrol></dt> +<dd>Specifies a network filesystem pool. When selecting <uicontrol>NFS</uicontrol>, +type the <uicontrol>NFS server IP</uicontrol> address and <uicontrol>NFS +path</uicontrol> (path of the exported directory).</dd> +</dlentry><dlentry> +<dt><uicontrol>iSCSI</uicontrol></dt> +<dd>Specifies a pool based on a target allocated on an iSCSI server. +When selecting <uicontrol>iSCSI</uicontrol>, type the <uicontrol>iSCSI +server</uicontrol> IP address and <uicontrol>Target</uicontrol> on +the iSCSI server. You can optionally select to add iSCSI authentication.</dd> +</dlentry><dlentry> +<dt><uicontrol>Logical</uicontrol></dt> +<dd>Specifies a logical volume storage pool. Select the location to +the device in <uicontrol>Device path</uicontrol>.</dd> +</dlentry><dlentry> +<dt><uicontrol>SCSI Fibre Channel</uicontrol></dt> +<dd>Specifies a pool based on an SCSI Fibre Channel. Select which +SCSI adapter to use.</dd> +</dlentry></dl><?Pub Caret 0?></li> +<li>Click <uicontrol>Create</uicontrol>.</li> +</ol> </p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000003914?> diff --git a/ui/pages/help/zh_CN/templates.dita b/ui/pages/help/zh_CN/templates.dita new file mode 100644 index 0000000..aee0726 --- /dev/null +++ b/ui/pages/help/zh_CN/templates.dita @@ -0,0 +1,122 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!--Arbortext, Inc., 1988-2011, v.4002--> +<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" + "..\dtd\cshelp.dtd"> +<?Pub Sty _display FontColor="red"?> +<?Pub Inc?> +<!--This DITA specialized document type is not supported by the Authoring Tools development team. +For support please see: +https://w3.opensource.ibm.com/projects/dita-cshelp/--> +<cshelp id="kimhtempl" xml:lang="en-us"> +<title>Templates</title> +<shortdesc>The <wintitle>Templates</wintitle> page shows the defined +virtual machine templates that can be used to create KVM guests.</shortdesc> +<csbody> +<p>For each template, the following information is displayed:<dl> +<dlentry> +<dt>OS</dt> +<dd>Name of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>Version of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>CPUs</dt> +<dd>Number of processors that are defined for the template.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of random access memory to be allocated, in MB.</dd> +</dlentry></dl></p> +<p>The following actions can be selected for each template:<ul> +<li>Select <uicontrol>Edit</uicontrol> to edit the template.</li> +<li>Select <uicontrol>Delete</uicontrol> to delete the template.</li> +</ul>To add a template, click the <uicontrol>plus (+)</uicontrol> icon +in the upper right of the display.</p> +</csbody> +<cshelp id="kimhedittempl" xml:lang="en-us"> +<title>Edit template</title> +<shortdesc>Edit an existing template.</shortdesc> +<csbody> +<p>For each template, the following information is displayed: <dl> +<dlentry> +<dt>Name</dt> +<dd>Name of the template.</dd> +</dlentry><dlentry> +<dt>Vendor</dt> +<dd>The name of the company that created the operating system or distribution +that the template is configured to use.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>The version of the operating system or distribution that the template +is configured to use.</dd> +</dlentry><dlentry> +<dt>CPU number</dt> +<dd>Number of processors that are defined for the template.</dd> +</dlentry><dlentry> +<dt>Memory</dt> +<dd>Amount of memory in MB to be allocated to the virtual machine.</dd> +</dlentry><dlentry> +<dt>Disk</dt> +<dd>Disk size in GB.</dd> +</dlentry><dlentry> +<dt>CDROM</dt> +<dd>File path to the location of the ISO file used to install the +KVM guest.</dd> +</dlentry><dlentry> +<dt>Storage pool</dt> +<dd>Specific storage pool or the default storage pool.</dd> +</dlentry><dlentry> +<dt>Network</dt> +<dd>Default network interfaces available to the KVM guest. You can +select multiple networks.</dd> +</dlentry></dl> Fields that are not disabled can be edited. After +you edit a field, click <uicontrol>Save</uicontrol>. </p> +</csbody> +</cshelp> +<cshelp id="kimhaddtempl"> +<title>Add template</title> +<shortdesc>Add a template from source media.</shortdesc> +<csbody> +<p>Select the location of the source media from the following options:<dl> +<dlentry> +<dt>Local ISO image</dt> +<dd>Select to scan storage pools for installation ISO images available +on the system.</dd> +</dlentry><dlentry> +<dt>Remote ISO image</dt> +<dd>Select to specify a remote location for an installation ISO image.</dd> +</dlentry></dl></p> +</csbody> +</cshelp> +<cshelp id="kimhaddloct"> +<title>Add template - local ISO image</title> +<shortdesc>Add a template from a local ISO image.</shortdesc> +<csbody> +<p>The ISO images available on the system are displayed.<dl><dlentry> +<dt>OS</dt> +<dd>Name of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Version</dt> +<dd>Version of the operating system or distribution.</dd> +</dlentry><dlentry> +<dt>Size</dt> +<dd>Size of the ISO image.</dd> +</dlentry></dl></p> +<p>To create a template from an ISO image, choose from the following +options:<ul> +<li>Select an ISO image from which to create a template, then click <uicontrol>Create +Templates from Selected ISO</uicontrol>.</li> +<li>Select <uicontrol>All</uicontrol> to create a template from each + listed ISO image, then click <uicontrol>Create Templates from Selected +ISO</uicontrol>.</li> +<li>If the ISO image that you want to use does not appear in the scan +results, you can select from the following options:<ul> +<li>Select <uicontrol>I want to use a specific ISO file</uicontrol> to +specify a path to the ISO image.</li> +<li>Click <uicontrol>Search more ISOs</uicontrol> to search for more +ISO images.</li> +</ul></li><?Pub Caret 0?> +</ul></p> +</csbody> +</cshelp> +</cshelp> +<?Pub *0000004433?> -- 1.7.10.4
From: Aline Manera <alinefm@br.ibm.com> The help pages will be translated so we need to adjust the build process to generate the html (from .dita files) to all the directories and also install the html files in the correct place according to the language. Signed-off-by: Aline Manera <alinefm@br.ibm.com> --- configure.ac | 3 +++ contrib/kimchi.spec.fedora.in | 2 +- contrib/kimchi.spec.suse.in | 2 +- ui/js/src/kimchi.main.js | 11 ++++++----- ui/pages/help/Makefile.am | 16 +++++++--------- ui/pages/help/en_US/Makefile.am | 23 +++++++++++++++++++++++ ui/pages/help/pt_BR/Makefile.am | 23 +++++++++++++++++++++++ ui/pages/help/zh_CN/Makefile.am | 23 +++++++++++++++++++++++ 8 files changed, 87 insertions(+), 16 deletions(-) create mode 100644 ui/pages/help/en_US/Makefile.am create mode 100644 ui/pages/help/pt_BR/Makefile.am create mode 100644 ui/pages/help/zh_CN/Makefile.am diff --git a/configure.ac b/configure.ac index a625f35..7d76f97 100644 --- a/configure.ac +++ b/configure.ac @@ -81,6 +81,9 @@ AC_CONFIG_FILES([ ui/libs/themes/base/images/Makefile ui/pages/Makefile ui/pages/help/Makefile + ui/pages/help/en_US/Makefile + ui/pages/help/pt_BR/Makefile + ui/pages/help/zh_CN/Makefile ui/pages/tabs/Makefile contrib/Makefile contrib/DEBIAN/Makefile diff --git a/contrib/kimchi.spec.fedora.in b/contrib/kimchi.spec.fedora.in index bf80104..1cd99b0 100644 --- a/contrib/kimchi.spec.fedora.in +++ b/contrib/kimchi.spec.fedora.in @@ -172,7 +172,7 @@ rm -rf $RPM_BUILD_ROOT %{_datadir}/kimchi/ui/libs/themes/base/images/*.gif %{_datadir}/kimchi/ui/libs/themes/base/jquery-ui.min.css %{_datadir}/kimchi/ui/pages/*.html.tmpl -%{_datadir}/kimchi/ui/pages/help/*.html +%{_datadir}/kimchi/ui/pages/help/*/*.html %{_datadir}/kimchi/ui/pages/tabs/*.html.tmpl %{_sysconfdir}/kimchi/kimchi.conf %{_sysconfdir}/kimchi/distros.d/debian.json diff --git a/contrib/kimchi.spec.suse.in b/contrib/kimchi.spec.suse.in index cba0899..efb2c08 100644 --- a/contrib/kimchi.spec.suse.in +++ b/contrib/kimchi.spec.suse.in @@ -98,7 +98,7 @@ rm -rf $RPM_BUILD_ROOT %{_datadir}/kimchi/ui/libs/themes/base/images/*.gif %{_datadir}/kimchi/ui/libs/themes/base/jquery-ui.min.css %{_datadir}/kimchi/ui/pages/*.html.tmpl -%{_datadir}/kimchi/ui/pages/help/*.html +%{_datadir}/kimchi/ui/pages/help/*/*.html %{_datadir}/kimchi/ui/pages/tabs/*.html.tmpl %{_sysconfdir}/kimchi/kimchi.conf %{_sysconfdir}/kimchi/distros.d/debian.json diff --git a/ui/js/src/kimchi.main.js b/ui/js/src/kimchi.main.js index 78206bf..ef64bf8 100644 --- a/ui/js/src/kimchi.main.js +++ b/ui/js/src/kimchi.main.js @@ -245,12 +245,13 @@ kimchi.main = function() { }; kimchi.getHelp = function(e) { - var url=window.location.hash; - url = url.replace("#tabs","/help"); - if (url == "/help") - url=url+"/index.html" + var url = window.location.hash; + var lang = kimchi.lang.get(); + url = url.replace("#tabs", "/help/" + lang); + if (url == "/help" + lang) + url = url + "/index.html" else - url=url+".html"; + url = url + ".html"; window.open(url, "Kimchi Help"); e.preventDefault(); diff --git a/ui/pages/help/Makefile.am b/ui/pages/help/Makefile.am index 719f603..1af984a 100644 --- a/ui/pages/help/Makefile.am +++ b/ui/pages/help/Makefile.am @@ -14,18 +14,16 @@ # License along with this library; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA -DITA_HTML_FILES = $(patsubst %.dita,%.html,$(wildcard *.dita)) -HTML_FILES = $(if $(DITA_HTML_FILES), $(DITA_HTML_FILES) index.html, $(wildcard *.html)) -DITA_XSL_FILE = dita-help.xsl - -helpdir = $(datadir)/kimchi/ui/pages/help +SUBDIRS = en_US pt_BR zh_CN -dist_help_DATA = $(HTML_FILES) $(NULL) +DITA_HTML_FILES = $(patsubst %.dita,%.html,$(wildcard */*.dita)) +HTML_FILES = $(if $(DITA_HTML_FILES), $(DITA_HTML_FILES), $(wildcard */*.html)) +DITA_XSL_FILE = dita-help.xsl -EXTRA_DIST = $(wildcard *.dita) +EXTRA_DIST = gen-index.py -index.html: $(wildcard *.dita) - $(shell pwd)/gen-index.py $^ > $@ +all: $(HTML_FILES) $(wildcard */*.dita) + @$(foreach dir, $(dir $(wildcard */)), $(shell pwd)/gen-index.py $(wildcard $(dir)*.dita) > $(dir)/index.html;) %.html: %.dita $(DITA_XSL_FILE) xsltproc -o $@ $(DITA_XSL_FILE) $< diff --git a/ui/pages/help/en_US/Makefile.am b/ui/pages/help/en_US/Makefile.am new file mode 100644 index 0000000..d5ab24f --- /dev/null +++ b/ui/pages/help/en_US/Makefile.am @@ -0,0 +1,23 @@ +# Copyright IBM Corp, 2014 +# +# This library is free software; you can redistribute it and/or +# modify it under the terms of the GNU Lesser General Public +# License as published by the Free Software Foundation; either +# version 2.1 of the License, or (at your option) any later version. +# +# This library is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public +# License along with this library; if not, write to the Free Software +# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + +en_US_helpdir = $(datadir)/kimchi/ui/pages/help/en_US + +dist_en_US_help_DATA = $(wildcard *.html) $(NULL) + +EXTRA_DIST = $(wildcard *.dita) + +CLEANFILES = $(wildcard *.html) diff --git a/ui/pages/help/pt_BR/Makefile.am b/ui/pages/help/pt_BR/Makefile.am new file mode 100644 index 0000000..0f1df92 --- /dev/null +++ b/ui/pages/help/pt_BR/Makefile.am @@ -0,0 +1,23 @@ +# Copyright IBM Corp, 2014 +# +# This library is free software; you can redistribute it and/or +# modify it under the terms of the GNU Lesser General Public +# License as published by the Free Software Foundation; either +# version 2.1 of the License, or (at your option) any later version. +# +# This library is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public +# License along with this library; if not, write to the Free Software +# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + +pt_BR_helpdir = $(datadir)/kimchi/ui/pages/help/pt_BR + +dist_pt_BR_help_DATA = $(wildcard *.html) $(NULL) + +EXTRA_DIST = $(wildcard *.dita) + +CLEANFILES = $(wildcard *.html) diff --git a/ui/pages/help/zh_CN/Makefile.am b/ui/pages/help/zh_CN/Makefile.am new file mode 100644 index 0000000..8b812ff --- /dev/null +++ b/ui/pages/help/zh_CN/Makefile.am @@ -0,0 +1,23 @@ +# Copyright IBM Corp, 2014 +# +# This library is free software; you can redistribute it and/or +# modify it under the terms of the GNU Lesser General Public +# License as published by the Free Software Foundation; either +# version 2.1 of the License, or (at your option) any later version. +# +# This library is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public +# License along with this library; if not, write to the Free Software +# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + +zh_CN_helpdir = $(datadir)/kimchi/ui/pages/help/zh_CN + +dist_zh_CN_help_DATA = $(wildcard *.html) $(NULL) + +EXTRA_DIST = $(wildcard *.dita) + +CLEANFILES = $(wildcard *.html) -- 1.7.10.4
From: Aline Manera <alinefm@br.ibm.com> The .dita files will be listed under the language directories to allow get a translatable version for them. Signed-off-by: Aline Manera <alinefm@br.ibm.com> --- ui/pages/help/guests.dita | 134 ------------------------------------------ ui/pages/help/host.dita | 70 ---------------------- ui/pages/help/network.dita | 68 --------------------- ui/pages/help/storage.dita | 98 ------------------------------ ui/pages/help/templates.dita | 122 -------------------------------------- 5 files changed, 492 deletions(-) delete mode 100644 ui/pages/help/guests.dita delete mode 100644 ui/pages/help/host.dita delete mode 100644 ui/pages/help/network.dita delete mode 100644 ui/pages/help/storage.dita delete mode 100644 ui/pages/help/templates.dita diff --git a/ui/pages/help/guests.dita b/ui/pages/help/guests.dita deleted file mode 100644 index f6e2c6c..0000000 --- a/ui/pages/help/guests.dita +++ /dev/null @@ -1,134 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!--Arbortext, Inc., 1988-2011, v.4002--> -<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" - "..\dtd\cshelp.dtd"> -<?Pub Sty _display FontColor="red"?> -<?Pub Inc?> -<!--This DITA specialized document type is not supported by the Authoring Tools development team. -For support please see: -https://w3.opensource.ibm.com/projects/dita-cshelp/--> -<cshelp id="kimhvirtm" xml:lang="en-us"> -<title>Guests</title> -<shortdesc>The <wintitle>Guests</wintitle> page lists the defined -KVM virtual machines.</shortdesc> -<csbody> -<p>For each guest, the following information is displayed:<dl><dlentry> -<dt>Name</dt> -<dd>Name of the virtual machine.</dd> -</dlentry><dlentry> -<dt>CPU</dt> -<dd>Percentage of processor utilization in the virtual machine.</dd> -</dlentry><dlentry> -<dt>Network I/O</dt> -<dd>Network input/output transmission rate in KB per seconds.</dd> -</dlentry><dlentry> -<dt>Disk I/O</dt> -<dd>Disk input/output transmission rate in KB per seconds.</dd> -</dlentry><dlentry> -<dt>Livetile</dt> -<dd>State of guest operating system console, or an icon that represents -the <tm tmtype="tm" trademark="Linux">Linux</tm> distribution if the -guest is not active.</dd> -</dlentry></dl></p> -<p>The following actions icons are displayed for each guest:<dl> -<dlentry> -<dt>Reset</dt> -<dd>Click to reset the guest. </dd> -</dlentry><dlentry> -<dt>Power (Start or Stop)</dt> -<dd>Click to power on or power off the guest. If the icon is red, -the power is off; if the icon is green, the power is on.</dd> -</dlentry></dl> </p> -<p>The following actions can be selected for each guest:<ul> -<li>Select <uicontrol>Connect</uicontrol> to connect to the remote -console for the guest operating system.</li> -<li>Select <uicontrol>Manage media</uicontrol> to change the path -to the installation media.</li> -<li>Select <uicontrol>Reset</uicontrol> to reset the guest.</li> -<li>Select <uicontrol>Edit</uicontrol> to edit the properties of an -existing guest. Guests can be edited only while stopped.</li> -<li>Select <uicontrol>Delete</uicontrol> to delete the guest.</li> -</ul>To create a guest, or virtual machine, click the <uicontrol>plus -(+)</uicontrol> icon in the upper right of the page.</p> -</csbody> -<cshelp id="kimhvirtmcrt" xml:lang="en-us"> -<title>Create virtual machine</title> -<shortdesc>Create a virtual machine by using an existing template.</shortdesc> -<csbody> -<p> <ol> -<li>Type the name to be used to identify the virtual machine.</li> -<li rev="rev1">Select a template. <ul> -<li>If templates exist, select from displayed templates.</li> -<li>If no templates exist, click <uicontrol>Create a template</uicontrol> to -create a template.</li> -</ul></li> -<li>Click <uicontrol>Create</uicontrol>.</li> -</ol> </p> -</csbody> -</cshelp> -<cshelp id="kimhvirtmedit" xml:lang="en-us"> -<title>Edit guest</title> -<shortdesc>Edit the properties of an existing virtual machine. Guests -can be edited only while stopped.</shortdesc> -<csprolog><csmetadata></csmetadata></csprolog> -<csbody> -<p>For each guest, the following information is displayed on the <wintitle>General</wintitle> tab:<dl> -<dlentry> -<dt>Name</dt> -<dd>Name of the virtual machine.</dd> -</dlentry><dlentry> -<dt>CPUs</dt> -<dd>Number of processors.</dd> -</dlentry><dlentry> -<dt>Memory</dt> -<dd>Amount of memory in MB.</dd> -</dlentry><dlentry> -<dt>Icon</dt> -<dd>Graphic image representing the Linux distribution to be displayed -in place of current status (Livetile) when the guest is not active.</dd> -</dlentry></dl></p> -<p>The following information is displayed on the <wintitle>Storage</wintitle> tab.</p> -<dl><dlentry> -<dt>Storage</dt> -<dd>Displays the location of the ISO file used for installation.</dd> -</dlentry></dl><?Pub Caret -2?> -<p> Fields that are not disabled can be edited. After you edit a field, -click <uicontrol>Save</uicontrol>. </p> -</csbody> -</cshelp> -<cshelp id="kimstoragedevice" xml:lang="en-us"> -<title>Add, replace, or detach a storage device</title> -<shortdesc rev="rev1">You can add, replace, or detach a storage device -to your virtual machine. The only supported device is CDROM. To edit -your storage devices, follow these steps:</shortdesc> -<csbody> -<ol> -<li>On the <wintitle>Edit Guest</wintitle> window, select <wintitle>Storage</wintitle>.</li> -<li>To replace a storage device, click the first icon with the <uicontrol>orange -slash (/)</uicontrol>. Enter the ISO file path and click <uicontrol>Replace</uicontrol>.</li> -<li>To detach a storage device, click the second icon with the <uicontrol>red -dash (-)</uicontrol>. Confirm the deletion and click <uicontrol>OK</uicontrol>.</li> -<li>To add a storage device, click the third icon with the green <uicontrol>plus -sign (+)</uicontrol>. Enter a device name and ISO file path and click <uicontrol>Attach</uicontrol>.</li> -</ol> -</csbody> -</cshelp> -<cshelp id="kimreplacemedia" xml:lang="en-us"> -<title>Replace a CDROM of VM</title> -<shortdesc rev="rev1">You can replace the contents of the CDROM for -a virtual machine after the installation is complete.</shortdesc> -<csbody> -<ol> -<li>Ensure that the virtual machine is started.</li> -<li>From the Actions menu, select <uicontrol>Manage Media</uicontrol>.</li> -<li>To change what is currently loaded in the CDROM, click the <uicontrol>orange -slash (/)</uicontrol> icon next to the hdc field.</li> -<li>On the <wintitle>Replace a CDROM of VM</wintitle> page, enter -the ISO file path. The other two fields are read-only.</li> -<li>Click <uicontrol>Replace</uicontrol>.</li> -</ol> -</csbody> -</cshelp> -<?tm 1391540919 3?> -</cshelp> -<?Pub *0000005541?> diff --git a/ui/pages/help/host.dita b/ui/pages/help/host.dita deleted file mode 100644 index 335c51c..0000000 --- a/ui/pages/help/host.dita +++ /dev/null @@ -1,70 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!--Arbortext, Inc., 1988-2011, v.4002--> -<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" - "..\dtd\cshelp.dtd"> -<?Pub Sty _display FontColor="red"?> -<?Pub Inc?> -<!--This DITA specialized document type is not supported by the Authoring Tools development team. -For support please see: -https://w3.opensource.ibm.com/projects/dita-cshelp/--> -<cshelp id="kimhhost" xml:lang="en-us"> -<title>Host</title> -<shortdesc>The <wintitle>Host</wintitle> page shows information about -the host system, and allows you to shut down, restart, and connect -to the host.</shortdesc> -<csbody> -<p>You can perform the following actions on the host:<ul> -<li>Select <uicontrol>Shut down</uicontrol> to shut down the host -system.</li> -<li>Select <uicontrol>Restart</uicontrol> to restart the host system.</li> -<li>Select <uicontrol>Connect</uicontrol> to open a VNC connection -to the host system, if it is not already connected.</li> -</ul></p> -<p>Click the following sections to display information about the host:<dl> -<dlentry> -<dt>Basic information</dt> -<dd>This section displays the host operating system distribution, -version, and code name, as well as the processor type and amount of -memory in GB.</dd> -</dlentry><dlentry> -<dt>System statistics</dt> -<dd>This section displays graphs to show statistics for CPU, memory, -disk I/O, and network I/O for the host. Select <uicontrol>Collecting -data after leaving this page</uicontrol> to continue collecting data -when the host tab is out of view.</dd> -</dlentry><dlentry> -<dt>Software Updates</dt> -<dd>This section displays information for all of the packages that -have updates available, including package name, version, architecture, -and repository. You can update all of the packages listed by selecting <uicontrol>Update -All</uicontrol>. You cannot select individual packages for updates.</dd> -</dlentry><dlentry> -<dt>Repositories</dt> -<dd>This section displays repositories that are associated with the -host system. You can add, enable, edit, or remove repositories. Adding -a repository associates it with the host system while enabling a repository -allows the host to access it. If your system is Red Hat Enterprise -Linux or Fedora, you can add <filepath>yum</filepath> repositories. -If your system is Ubuntu or Debian, then add <filepath>deb</filepath> repositories.<p>If -you are working with yum repositories, you can add a GPG check to -verify that a package from this repository have not been corrupted. -Select a repository and then <uicontrol>Edit</uicontrol>. Select <uicontrol>Yes</uicontrol> to -enable GPG Check and then enter a URL to the GPG key file for the -repository.</p><?Pub Caret 156?></dd> -</dlentry><dlentry> -<dt>Debug reports</dt> -<dd>This section displays debug reports, including name and file path. -You can select from options to generate a new report, or rename, remove, -or download an existing report.<p>The debug report is generated using -the <cmdname>sosreport</cmdname> command. It is available for Red -Hat Enterprise <tm tmtype="tm" trademark="Linux">Linux</tm>, Fedora, -and Ubuntu distributions. The command generates a .tar file that contains -configuration and diagnostic information, such as the running kernel -version, loaded modules, and system and service configuration files. -The command also runs external programs to collect further information -and stores this output in the resulting archive.</p> </dd> -</dlentry></dl></p> -</csbody> -<?tm 1392659967 1?> -</cshelp> -<?Pub *0000003492?> diff --git a/ui/pages/help/network.dita b/ui/pages/help/network.dita deleted file mode 100644 index 25c05ff..0000000 --- a/ui/pages/help/network.dita +++ /dev/null @@ -1,68 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!--Arbortext, Inc., 1988-2011, v.4002--> -<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" - "..\dtd\cshelp.dtd"> -<?Pub Sty _display FontColor="red"?> -<?Pub Inc?> -<!--This DITA specialized document type is not supported by the Authoring Tools development team. -For support please see: -https://w3.opensource.ibm.com/projects/dita-cshelp/--> -<cshelp id="kimhnetw" xml:lang="en-us"> -<title>Network</title> -<shortdesc>The <wintitle>Network</wintitle> page displays information -about the network connection.</shortdesc> -<csbody> -<p><dl><dlentry> -<dt>Network Name</dt> -<dd>Name of the network, or <uicontrol>default</uicontrol>.</dd> -</dlentry><dlentry> -<dt>State</dt> -<dd>State of the network, active (green) or inactive (red). </dd> -</dlentry><dlentry> -<dt>Network type</dt> -<dd>Network type, for example, <uicontrol>NAT</uicontrol> (network -address translation).</dd> -</dlentry><dlentry> -<dt>Interface</dt> -<dd>Network interface, for example, <uicontrol>virbr0</uicontrol> (default).</dd> -</dlentry><dlentry> -<dt>Address space</dt> -<dd>IP address.</dd> -</dlentry></dl></p> -<p>The following actions can be selected:<ul> -<li rev="rev1">Select <uicontrol>Start</uicontrol> to begin the network -connection.</li> -<li>Select <uicontrol>Stop</uicontrol> to end the network connection.</li> -<li>Select <uicontrol>Delete</uicontrol> to delete the connection -information.</li> -</ul>To create a network, click the <uicontrol>plus (+)</uicontrol> icon -in the upper right of the display.</p> -</csbody> -<cshelp id="kimhnetwcrt" xml:lang="en-us"> -<title>Create a network</title> -<shortdesc>Create a network.</shortdesc> -<csbody> -<p> <ol> -<li>Type the name of the network.</li> -<li>Click to select the network type. <dl rev="rev1"><dlentry> -<dt><uicontrol>Isolated</uicontrol></dt> -<dd>Isolated mode. Guests cannot send or receive communication to -or from external systems.</dd> -</dlentry><dlentry> -<dt><uicontrol>NAT</uicontrol></dt> -<dd>Network Address Translation mode. Communication from guests to -external systems uses the host IP address. External systems cannot -initiate communication to guests.</dd> -</dlentry><dlentry> -<dt><uicontrol>Bridged</uicontrol></dt> -<dd>Bridged mode. Guests can communicate with external systems and -be contacted by external systems as if they were physical systems -on the network. For bridged mode, you must specify additional destination -and VLAN information.</dd> -</dlentry></dl><?Pub Caret 224?></li> -<li>Click <uicontrol>Create</uicontrol>.</li> -</ol> </p> -</csbody> -</cshelp> -</cshelp> -<?Pub *0000002571?> diff --git a/ui/pages/help/storage.dita b/ui/pages/help/storage.dita deleted file mode 100644 index 12ce15c..0000000 --- a/ui/pages/help/storage.dita +++ /dev/null @@ -1,98 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!--Arbortext, Inc., 1988-2011, v.4002--> -<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" - "..\dtd\cshelp.dtd"> -<?Pub Sty _display FontColor="red"?> -<?Pub Inc?> -<!--This DITA specialized document type is not supported by the Authoring Tools development team. -For support please see: -https://w3.opensource.ibm.com/projects/dita-cshelp/--> -<cshelp id="kimhstor" xml:lang="en-us"> -<title>Storage</title> -<shortdesc>The <wintitle>Storage</wintitle> page lists the available -storage pools, including the default storage pool.</shortdesc> -<csbody> -<p>For each storage pool, the following information is displayed:<dl> -<dlentry> -<dt>Name</dt> -<dd>Name of the storage pool and percentage used.</dd> -</dlentry><dlentry> -<dt>State</dt> -<dd>State of the storage pool, active (green) or inactive (red). </dd> -</dlentry><dlentry> -<dt>Location</dt> -<dd>File path to the location of the storage pool.</dd> -</dlentry><dlentry> -<dt>Type</dt> -<dd>Type of storage pool, for example, <uicontrol>dir</uicontrol>.</dd> -</dlentry><dlentry> -<dt>Capacity</dt> -<dd>Amount of space in the storage pool.</dd> -</dlentry><dlentry> -<dt>Allocated</dt> -<dd>Amount of space that is already allocated in the storage pool.</dd> -</dlentry></dl></p> -<p>The following actions can be selected for each storage pool:<ul> -<li>Select <uicontrol>Activate</uicontrol> to activate the storage -pool so that it can be used.</li> -<li>Select <uicontrol>Deactivate</uicontrol> to deactivate an active -storage pool.</li> -<li>Select <uicontrol>Undefine</uicontrol> to remove an inactive storage -pool.</li> -</ul></p> -<p>To display storage volume details for a storage pool, click the -arrow on the right side of the storage pool row. Details include -the following:<dl><dlentry> -<dt>Type</dt> -<dd>The type of volume, for example, <uicontrol>file</uicontrol>.</dd> -</dlentry><dlentry> -<dt>Format</dt> -<dd>The format, varying dependent on the type.</dd> -</dlentry><dlentry> -<dt>Capacity</dt> -<dd>Size of the storage volume.</dd> -</dlentry><dlentry> -<dt>Allocation</dt> -<dd>Amount of space that is already allocated in the storage pool.</dd> -</dlentry></dl>To define a storage pool, click the <uicontrol>plus -(+)</uicontrol> icon in the upper right of the display.</p> -</csbody> -<cshelp id="kimhdefstor" xml:lang="en-us"> -<title>Define a storage pool</title> -<shortdesc> Define a storage pool.</shortdesc> -<csbody> -<p> <ol> -<li>In the <uicontrol>Storage pool name</uicontrol> field, type the -name to be used to identify the storage pool.</li> -<li>In the <uicontrol>Storage pool type</uicontrol> list, select the -type: <dl><dlentry> -<dt><uicontrol>DIR</uicontrol></dt> -<dd>Specifies a directory pool. When selecting <uicontrol>DIR</uicontrol>, -type the <uicontrol>Storage path</uicontrol> (file path to the storage -pool).</dd> -</dlentry><dlentry> -<dt><uicontrol>NFS</uicontrol></dt> -<dd>Specifies a network filesystem pool. When selecting <uicontrol>NFS</uicontrol>, -type the <uicontrol>NFS server IP</uicontrol> address and <uicontrol>NFS -path</uicontrol> (path of the exported directory).</dd> -</dlentry><dlentry> -<dt><uicontrol>iSCSI</uicontrol></dt> -<dd>Specifies a pool based on a target allocated on an iSCSI server. -When selecting <uicontrol>iSCSI</uicontrol>, type the <uicontrol>iSCSI -server</uicontrol> IP address and <uicontrol>Target</uicontrol> on -the iSCSI server. You can optionally select to add iSCSI authentication.</dd> -</dlentry><dlentry> -<dt><uicontrol>Logical</uicontrol></dt> -<dd>Specifies a logical volume storage pool. Select the location to -the device in <uicontrol>Device path</uicontrol>.</dd> -</dlentry><dlentry> -<dt><uicontrol>SCSI Fibre Channel</uicontrol></dt> -<dd>Specifies a pool based on an SCSI Fibre Channel. Select which -SCSI adapter to use.</dd> -</dlentry></dl><?Pub Caret 0?></li> -<li>Click <uicontrol>Create</uicontrol>.</li> -</ol> </p> -</csbody> -</cshelp> -</cshelp> -<?Pub *0000003914?> diff --git a/ui/pages/help/templates.dita b/ui/pages/help/templates.dita deleted file mode 100644 index aee0726..0000000 --- a/ui/pages/help/templates.dita +++ /dev/null @@ -1,122 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!--Arbortext, Inc., 1988-2011, v.4002--> -<!DOCTYPE cshelp PUBLIC "-//IBM//DTD DITA CSHelp//EN" - "..\dtd\cshelp.dtd"> -<?Pub Sty _display FontColor="red"?> -<?Pub Inc?> -<!--This DITA specialized document type is not supported by the Authoring Tools development team. -For support please see: -https://w3.opensource.ibm.com/projects/dita-cshelp/--> -<cshelp id="kimhtempl" xml:lang="en-us"> -<title>Templates</title> -<shortdesc>The <wintitle>Templates</wintitle> page shows the defined -virtual machine templates that can be used to create KVM guests.</shortdesc> -<csbody> -<p>For each template, the following information is displayed:<dl> -<dlentry> -<dt>OS</dt> -<dd>Name of the operating system or distribution.</dd> -</dlentry><dlentry> -<dt>Version</dt> -<dd>Version of the operating system or distribution.</dd> -</dlentry><dlentry> -<dt>CPUs</dt> -<dd>Number of processors that are defined for the template.</dd> -</dlentry><dlentry> -<dt>Memory</dt> -<dd>Amount of random access memory to be allocated, in MB.</dd> -</dlentry></dl></p> -<p>The following actions can be selected for each template:<ul> -<li>Select <uicontrol>Edit</uicontrol> to edit the template.</li> -<li>Select <uicontrol>Delete</uicontrol> to delete the template.</li> -</ul>To add a template, click the <uicontrol>plus (+)</uicontrol> icon -in the upper right of the display.</p> -</csbody> -<cshelp id="kimhedittempl" xml:lang="en-us"> -<title>Edit template</title> -<shortdesc>Edit an existing template.</shortdesc> -<csbody> -<p>For each template, the following information is displayed: <dl> -<dlentry> -<dt>Name</dt> -<dd>Name of the template.</dd> -</dlentry><dlentry> -<dt>Vendor</dt> -<dd>The name of the company that created the operating system or distribution -that the template is configured to use.</dd> -</dlentry><dlentry> -<dt>Version</dt> -<dd>The version of the operating system or distribution that the template -is configured to use.</dd> -</dlentry><dlentry> -<dt>CPU number</dt> -<dd>Number of processors that are defined for the template.</dd> -</dlentry><dlentry> -<dt>Memory</dt> -<dd>Amount of memory in MB to be allocated to the virtual machine.</dd> -</dlentry><dlentry> -<dt>Disk</dt> -<dd>Disk size in GB.</dd> -</dlentry><dlentry> -<dt>CDROM</dt> -<dd>File path to the location of the ISO file used to install the -KVM guest.</dd> -</dlentry><dlentry> -<dt>Storage pool</dt> -<dd>Specific storage pool or the default storage pool.</dd> -</dlentry><dlentry> -<dt>Network</dt> -<dd>Default network interfaces available to the KVM guest. You can -select multiple networks.</dd> -</dlentry></dl> Fields that are not disabled can be edited. After -you edit a field, click <uicontrol>Save</uicontrol>. </p> -</csbody> -</cshelp> -<cshelp id="kimhaddtempl"> -<title>Add template</title> -<shortdesc>Add a template from source media.</shortdesc> -<csbody> -<p>Select the location of the source media from the following options:<dl> -<dlentry> -<dt>Local ISO image</dt> -<dd>Select to scan storage pools for installation ISO images available -on the system.</dd> -</dlentry><dlentry> -<dt>Remote ISO image</dt> -<dd>Select to specify a remote location for an installation ISO image.</dd> -</dlentry></dl></p> -</csbody> -</cshelp> -<cshelp id="kimhaddloct"> -<title>Add template - local ISO image</title> -<shortdesc>Add a template from a local ISO image.</shortdesc> -<csbody> -<p>The ISO images available on the system are displayed.<dl><dlentry> -<dt>OS</dt> -<dd>Name of the operating system or distribution.</dd> -</dlentry><dlentry> -<dt>Version</dt> -<dd>Version of the operating system or distribution.</dd> -</dlentry><dlentry> -<dt>Size</dt> -<dd>Size of the ISO image.</dd> -</dlentry></dl></p> -<p>To create a template from an ISO image, choose from the following -options:<ul> -<li>Select an ISO image from which to create a template, then click <uicontrol>Create -Templates from Selected ISO</uicontrol>.</li> -<li>Select <uicontrol>All</uicontrol> to create a template from each - listed ISO image, then click <uicontrol>Create Templates from Selected -ISO</uicontrol>.</li> -<li>If the ISO image that you want to use does not appear in the scan -results, you can select from the following options:<ul> -<li>Select <uicontrol>I want to use a specific ISO file</uicontrol> to -specify a path to the ISO image.</li> -<li>Click <uicontrol>Search more ISOs</uicontrol> to search for more -ISO images.</li> -</ul></li><?Pub Caret 0?> -</ul></p> -</csbody> -</cshelp> -</cshelp> -<?Pub *0000004433?> -- 1.7.10.4
From: Aline Manera <alinefm@br.ibm.com> We should use absolute paths to point to css or other link url to avoid directory struture dependencies. Fix it. Signed-off-by: Aline Manera <alinefm@br.ibm.com> --- ui/pages/help/dita-help.xsl | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ui/pages/help/dita-help.xsl b/ui/pages/help/dita-help.xsl index 0821942..2ea1c38 100644 --- a/ui/pages/help/dita-help.xsl +++ b/ui/pages/help/dita-help.xsl @@ -8,8 +8,8 @@ <html> <head> <title><xsl:value-of select="/cshelp/title" /></title> - <link rel="shortcut icon" href="../images/logo.ico" /> - <link rel="stylesheet" type="text/css" href="kimchi.css" /> + <link rel="shortcut icon" href="/images/logo.ico" /> + <link rel="stylesheet" type="text/css" href="/help/kimchi.css" /> </head> <body> <xsl:apply-templates select="//cshelp" /> -- 1.7.10.4
From: Aline Manera <alinefm@br.ibm.com> The html files will be now in /help subdirectories so update the .gitignore file accordingly. Signed-off-by: Aline Manera <alinefm@br.ibm.com> --- .gitignore | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 67878e2..073f46e 100644 --- a/.gitignore +++ b/.gitignore @@ -35,4 +35,4 @@ po/gen-pot *.orig *.rej *.pem -ui/pages/help/*.html +ui/pages/help/*/*.html -- 1.7.10.4
From: Aline Manera <alinefm@br.ibm.com> That way user can easily access help from an intuitive URI. Set the default help pages to English. Signed-off-by: Aline Manera <alinefm@br.ibm.com> --- src/kimchi/config.py.in | 1 + 1 file changed, 1 insertion(+) diff --git a/src/kimchi/config.py.in b/src/kimchi/config.py.in index d15a6b5..04218c2 100644 --- a/src/kimchi/config.py.in +++ b/src/kimchi/config.py.in @@ -196,6 +196,7 @@ class KimchiConfig(dict): '/help': { 'tools.staticdir.on': True, 'tools.staticdir.dir': '%s/ui/pages/help' % paths.prefix, + 'tools.staticdir.index': 'en_US/index.html', 'tools.nocache.on': False } } -- 1.7.10.4
Reviewed-by: Daniel Barboza <danielhb@linux.vnet.ibm.com> Tested-by: Daniel Barboza <danielhb@linux.vnet.ibm.com> ^ for the entire patch set On 04/08/2014 02:02 PM, Aline Manera wrote:
From: Aline Manera <alinefm@br.ibm.com>
This patch set updates the build process and also de UI to get translated help pages.
Aline Manera (6): Replicate help pages for pt_BR and zh_CN Update build process to generate html pages for each help subdir help pages: Remove former .dita files help pages: Adjust css url help pages: Update .gitignore file help pages: Set default index file to /help URI
.gitignore | 2 +- configure.ac | 3 + contrib/kimchi.spec.fedora.in | 2 +- contrib/kimchi.spec.suse.in | 2 +- src/kimchi/config.py.in | 1 + ui/js/src/kimchi.main.js | 11 +-- ui/pages/help/Makefile.am | 16 ++--- ui/pages/help/dita-help.xsl | 4 +- ui/pages/help/en_US/Makefile.am | 23 +++++++ ui/pages/help/en_US/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/en_US/host.dita | 70 +++++++++++++++++++ ui/pages/help/en_US/network.dita | 68 ++++++++++++++++++ ui/pages/help/en_US/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/en_US/templates.dita | 122 ++++++++++++++++++++++++++++++++ ui/pages/help/guests.dita | 134 ------------------------------------ ui/pages/help/host.dita | 70 ------------------- ui/pages/help/network.dita | 68 ------------------ ui/pages/help/pt_BR/Makefile.am | 23 +++++++ ui/pages/help/pt_BR/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/pt_BR/host.dita | 70 +++++++++++++++++++ ui/pages/help/pt_BR/network.dita | 68 ++++++++++++++++++ ui/pages/help/pt_BR/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/pt_BR/templates.dita | 122 ++++++++++++++++++++++++++++++++ ui/pages/help/storage.dita | 98 -------------------------- ui/pages/help/templates.dita | 122 -------------------------------- ui/pages/help/zh_CN/Makefile.am | 23 +++++++ ui/pages/help/zh_CN/guests.dita | 134 ++++++++++++++++++++++++++++++++++++ ui/pages/help/zh_CN/host.dita | 70 +++++++++++++++++++ ui/pages/help/zh_CN/network.dita | 68 ++++++++++++++++++ ui/pages/help/zh_CN/storage.dita | 98 ++++++++++++++++++++++++++ ui/pages/help/zh_CN/templates.dita | 122 ++++++++++++++++++++++++++++++++ 31 files changed, 1567 insertions(+), 511 deletions(-) create mode 100644 ui/pages/help/en_US/Makefile.am create mode 100644 ui/pages/help/en_US/guests.dita create mode 100644 ui/pages/help/en_US/host.dita create mode 100644 ui/pages/help/en_US/network.dita create mode 100644 ui/pages/help/en_US/storage.dita create mode 100644 ui/pages/help/en_US/templates.dita delete mode 100644 ui/pages/help/guests.dita delete mode 100644 ui/pages/help/host.dita delete mode 100644 ui/pages/help/network.dita create mode 100644 ui/pages/help/pt_BR/Makefile.am create mode 100644 ui/pages/help/pt_BR/guests.dita create mode 100644 ui/pages/help/pt_BR/host.dita create mode 100644 ui/pages/help/pt_BR/network.dita create mode 100644 ui/pages/help/pt_BR/storage.dita create mode 100644 ui/pages/help/pt_BR/templates.dita delete mode 100644 ui/pages/help/storage.dita delete mode 100644 ui/pages/help/templates.dita create mode 100644 ui/pages/help/zh_CN/Makefile.am create mode 100644 ui/pages/help/zh_CN/guests.dita create mode 100644 ui/pages/help/zh_CN/host.dita create mode 100644 ui/pages/help/zh_CN/network.dita create mode 100644 ui/pages/help/zh_CN/storage.dita create mode 100644 ui/pages/help/zh_CN/templates.dita
participants (2)
-
Aline Manera -
Daniel H Barboza