index.xml

Delivered as text/xml

[ hide source ] | [ make this the default ]

File Contents

<?xml version='1.0'?>

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!-- Global variables are defined in variables.ent -->
<!ENTITY % myvars SYSTEM "variables.ent">
%myvars;

]>

<book>
<title>OpenACS Core Documentation</title>

<part id="for-everyone">
  <title>OpenACS For Everyone</title>

  <chapter id="general-documents">
    <title>High level information: What is OpenACS?</title>

    <sect1 id="openacs-overview" xreflabel="OpenACS Overview">
      <title>Overview</title>
      <para>
        OpenACS (Open Architecture Community System) is an
        advanced toolkit for building scalable, community-oriented
        web applications.  If you&#39;re thinking of building an
        enterprise-level web application, OpenACS is a solid,
        scalable framework for building dynamic content driven
        sites.
      </para>

      <para>
        OpenACS is a collection of pre-built applications and
        services that you can use to build your web
        site/application. Through a modular architecture, OpenACS
        has packages for user/groups management, content
        management, e-commerce, news, FAQs, calendar, forums, bug
        tracking, full-text searching, and <ulink
        url="http://openacs.org/packages/">much
        more</ulink>.
      </para>


      <para>
        OpenACS relies on <ulink
        url="http://www.aolserver.com/">AOLserver</ulink>, the
        free, multithreaded, scalable, Tcl-enabled,
        web/application server used by America Online for most of
        its web sites, and a true ACID-compliant Relational
        Database Management System (RDBMS). Currently OpenACS
        supports PostgreSQL, an open source RDBMS, and Oracle and
        is easily extensible to other databases which support a
        comparable feature set.
      </para>

      <para>
        The OpenACS toolkit is derived from the ArsDigita
        Community System (ACS). ArsDigita (now part of Red Hat,
        Inc.) kindly made their work available under the <ulink
        url="http://www.gnu.org/licenses/gpl.txt">GPL</ulink>,
        making all of this possible.
      </para>

      <para>
        The OpenACS project was born when Don Baccus, Ben Adida, and
        others decided to port ACS from Oracle to PostgreSQL, thus
        making it a fully open-source solution.  With OpenACS 4,
        Oracle and PostgreSQL support were combined in one code base
        and with OpenACS 5, support for internationalization and
        localization has been added.
      </para>

      <para>
        A vibrant and productive community has sprung up around the
        OpenACS software and there are many volunteer contributors
        as well as a commercial companies able to provide support,
        hosting, and custom development.  Many of the production
        users are actively funding and contributing work back to the
        project.  Formal, consensus driven governance has been
        established (with semi-annual elections) which ensures the
        project serves the needs of it&#39;s constituents.
      </para>

      <para>
        The OpenACS community would like to hear your comments and
        can help you in your endeavors with the system. Visit our
        <ulink url="http://openacs.org/">web site</ulink> and feel
        free to <ulink url="http://openacs.org/forums/">ask questions or provide feedback</ulink>.
      </para>
    </sect1>
    <xi:include href="for-everyone/release-notes.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Release Notes Section Missing</xi:fallback>
    </xi:include>
  </chapter>
</part>

<part id="acs-admin">
  <title>Administrator&#39;s Guide</title>

  <chapter id="install-overview">
    <title>Installation Overview</title>

    <authorblurb>
      <para>by <ulink url="mailto:vinod@kurup.com">Vinod Kurup</ulink></para>
    </authorblurb>

    <xi:include href="install-guide/overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Overview Section Missing</xi:fallback>
    </xi:include>
    <!--
	<xi:include href="install-guide/quick.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
	<xi:fallback><para>Quick Guide Missing</para></xi:fallback>
	</xi:include>
    -->
    <xi:include href="install-guide/software.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section Missing</xi:fallback>
    </xi:include>
  </chapter>

  <chapter id="complete-install">
    <title>Complete Installation</title>
    <xi:include href="install-guide/os.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section Missing</xi:fallback>
    </xi:include>

    <xi:include href="install-guide/oracle.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback><para>Section Missing</para></xi:fallback>
    </xi:include>
    <xi:include  href="install-guide/postgres.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section Missing</xi:fallback>
    </xi:include>

    <xi:include href="install-guide/aolserver4.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section Missing</xi:fallback>
    </xi:include>

    <xi:include href="install-guide/openacs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section Missing</xi:fallback>
    </xi:include>

    <xi:include href="install-guide/win2kinstall.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>

    <xi:include href="install-guide/macinstall.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
  </chapter>

  <xi:include href="install-guide/configuring.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>

  <xi:include href="install-guide/upgrade.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>
  
  <xi:include href="install-guide/maintenance.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>

  <xi:include href="install-guide/database-maintenance.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>

  <xi:include href="install-guide/recovery.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>


  <xi:include href="install-guide/red-hat.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>

  <xi:include href="install-guide/other-software.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>

  <xi:include href="install-guide/credits.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Credits Section Missing</xi:fallback>
  </xi:include>
</part>

<part id="acs-package-dev">
  <title>For OpenACS Package Developers</title>
  <partintro>
    <para>Tutorials and reference material for creating new OpenACS packages.
    </para>
  </partintro>

  <chapter id="tutorial"> 
    <title>Development Tutorial</title>
    <xi:include href="developers-guide/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/tutorial-db.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/tutorial-pages.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/tutorial-debug.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
  </chapter>
  <xi:include href="developers-guide/tutorial-advanced.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>

  <chapter id="dev-guide">
    <title>Development Reference</title>

    <xi:include href="developers-guide/packages.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/objects.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/rp.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/db-api.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/permissions.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/subsites.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/parties.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/permissions-tediously-explained.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/object-identity.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/programming-with-aolserver.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="developers-guide/form-builder.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
  </chapter>

  <chapter id="eng-standards">
    <title>Engineering Standards</title>

    <xi:include href="engineering-standards/style-guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    
    <xi:include href="engineering-standards/cvs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/eng-standards-versioning.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/constraint-naming.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/filenaming.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/plsql.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/variables.xml"  xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/auto-testing.xml"  xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>

  </chapter>

  <chapter id="doc-standards">
    <title>Documentation Standards</title>
    <xi:include href="engineering-standards/docbook-primer.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/psgml-mode.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/nxml-mode.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/design-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="engineering-standards/requirements-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
  </chapter>

  <xi:include href="developers-guide/i18n.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>Section missing</xi:fallback>
  </xi:include>

  <xi:include href="developers-guide/cvs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>CVS Section missing</xi:fallback>
  </xi:include>

</part>

<part id="acs-plat-dev">
  <title>For OpenACS Platform Developers</title>
  <chapter id="kernel-doc">
    <title>Kernel Documentation</title>

    <sect1 id="kernel-overview">
      <title>Overview</title>

      <itemizedlist>
        <listitem>
          <para>
            The <emphasis>OpenACS Kernel</emphasis>, which
            handles system-wide necessities such as metadata,
            security, users and groups, subsites, and package
            management and deployment.
          </para>
        </listitem>
        <listitem>
          <para>
            The <emphasis>OpenACS Core</emphasis>, which
            comprises all the other packages that ship with the
            kernel and are most frequently needed by users, such as
            templating, forums, and user
            registration/management. The packages tend to be
            developed and distributed with the kernel.
          </para>
        </listitem>
        <listitem>
          <para>

            <emphasis>OpenACS Application packages</emphasis>,
            which typically provide user-level
            web services built on top of the Kernel and Core.
            Application packages are
            developed separately from the Kernel, and are typically
            released independently of it.

          </para>
        </listitem>
      </itemizedlist>
      <para>
        This document provides a high-level overview of the kernel
        package. <ulink url="index.html">Documentation for other packages on this server</ulink>
      </para>
    </sect1>

    <xi:include href="kernel/object-system-req.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/object-system-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/permissions-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/permissions-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/groups-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/groups-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/subsites-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/subsites-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/apm-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/apm-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/db-api.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/i18n-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/security-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/security-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/security-notes.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/rp-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/rp-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/tcl-doc.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/bootstrap-acs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
    <xi:include href="kernel/ext-auth.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
      <xi:fallback>Section missing</xi:fallback>
    </xi:include>
  </chapter>
  <xi:include href="releasing-openacs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
    <xi:fallback>'Releasing OpenACS' missing</xi:fallback>
  </xi:include>

</part>
<index></index>
</book>