Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
HTML Shell Perl

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
content/en_us
tools
.gitignore
LICENSE
README

README

Welcome
-------

This repository contains the installation, administration, user, and reference
documentation for Eucalyptus. It includes files for generating guides published
on the Eucalyptus website (www.eucalyptus.com).

Contributing to Eucalyptus
--------------------------

Eucalyptus welcomes all people interested in cloud computing. We recommend that
you connect with other Eucalyptus users or get actively involved with Eucalyptus
development, including documentation.

The Eucalyptus IRC channel is #eucalyptus on Freenode. This channel is used for
real-time communication among users and developers. Information about how to use
the network is available from Freenode
(http://freenode.net/using_the_network.shtml).

The Eucalyptus community mailing list is community@lists.eucalyptus.com. This
list is used for user discussions, problem reports, and other communications.
Information about how to subscribe is available at
http://lists.eucalyptus.com/cgi-bin/mailman/listinfo/community.

Building Documentation
----------------------

If you want to generate HTML or PDF from the files in this repository, perform
the following tasks:

  * Make sure that you have Java and ANT.

  * Create environment variables for DOC_HOME (path to the euca/content/en_us directory
    is), DITA_HOME (path to the euca/tools/DITA-OT directory), JAVA_HOME, and
    ANT_HOME.

  * In the build.properties file for the guide you want to build, change the
    pdf.formatter value from xep to fop:

    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    pdf.formatter=fop
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  * Run the shell script DITA-OT/startcmd.sh (or startcmd.bat in Windows) to set
    up the necessary environment variables.

  * In the same shell window, change directories to the directory you want to
    generate documentation for.

  * Enter ant and the type of output you want (pdf or xhtml):

    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    ant pdf
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Something went wrong with that request. Please try again.