Index: openacs-4/packages/acs-core-docs/www/xml/index.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/index.xml,v
diff -u -N -r1.19.2.7 -r1.19.2.8
--- openacs-4/packages/acs-core-docs/www/xml/index.xml 2 Dec 2003 17:39:31 -0000 1.19.2.7
+++ openacs-4/packages/acs-core-docs/www/xml/index.xml 6 Dec 2003 21:22:58 -0000 1.19.2.8
@@ -19,80 +19,73 @@
Overview
-
- OpenACS (Open Architecture Community System) is an
- advanced toolkit for building scalable, community-oriented
- web applications. If you're thinking of building an
- enterprise-level web application, OpenACS is a solid,
- proven foundation that will give you a 3-6 month
- headstart.
-
+
+ OpenACS (Open Architecture Community System) is an
+ advanced toolkit for building scalable, community-oriented
+ web applications. If you're thinking of building an
+ enterprise-level web application, OpenACS is a solid,
+ scalable framework for building dynamic content driven
+ sites.
+
-
- OpenACS is also 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, FAQ, calendar, forums, bug
- tracking, full-text searching, and much
+
+ 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 much
more.
-
+
-
- OpenACS relies on
+ OpenACS relies on AOLserver, the
- free, multithreaded, scalable, Tcl-enabled,
- web/application server used by America On-Line 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. (read
- more)
-
+ 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.
+
-
- The OpenACS toolkit is based on the ArsDigita Community
- System. ArsDigita (now part of Red Hat, Inc.) kindly made
- their work available under the GPL,
- making all of this possible.
-
+
+ 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 GPL,
+ making all of this possible.
+
- The ArsDigita Community System (ACS) is a toolkit of software
- that will help you build Web services with a collaborative dimension,
- ranging from knowledge management within companies to B2C ecommerce
- to product support and community among the customers. The software is
- free and open-source and has been tested in heavy use since
- 1995. - Philip Greenspun
-
+ 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.
+
-
- OpenACS was born when Don Baccus, Ben Adida, et al decided
- to port ACS from Oracle to PostgreSQL, thus making it a
- fully open-source solution.
+
+ 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's constituents.
-
- OpenACS &version; is the next generation of the web toolkit. It's based on
- ACS 4, but no longer follows ArsDigita development. Unlike ACS
- (which required Oracle) and OpenACS 3.x (which required PostgreSQL),
- OpenACS &version; allows you to use either database. It's also built in such
- a way to allow enterprising hackers (in the good sense of
- the word) to extend it to other databases. Don Baccus leads
- the development and numerous developers and non-developers
- contribute from around the world.
-
-
- The OpenACS community would like to hear your comments and
- help you in your endeavors with the system. Stop by our
- web site and feel
- free to ask a question, post ideas or whatever.
-
+ The OpenACS community would like to hear your comments and
+ can help you in your endeavors with the system. Visit our
+ web site and feel
+ free to ask questions or provide feedback.
+ Release Notes Section Missing
@@ -292,6 +285,9 @@
Section missing
+
+ Section missing
+ Section missing
Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/nxml-mode.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/nxml-mode.xml,v
diff -u -N
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/nxml-mode.xml 6 Dec 2003 21:22:58 -0000 1.1.2.1
@@ -0,0 +1,28 @@
+
+
+%myvars;
+]>
+
+ Using nXML mode in Emacs
+
+
+ By Jeff Davis
+
+
+
+ An alternative to psgml mode is nXML by James Clark, a new major mode for GNU Emacs
+ for editing XML, and which features highlighting, indentation, and on the fly validation versus a RelaxNG Schema.
+
+
+ An
+ introduction to nXML mode at xmlhack.com.
+
+
+ The nXML mode mail list at groups.yahoo.com.
+
+ The nXML download page at thaiopensource.com.
+
+
+
\ No newline at end of file
Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml,v
diff -u -N -r1.17.2.2 -r1.17.2.3
--- openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 29 Nov 2003 15:17:54 -0000 1.17.2.2
+++ openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 6 Dec 2003 21:22:58 -0000 1.17.2.3
@@ -4,408 +4,411 @@
%myvars;
]>
-
-
- Basic Steps
-
- The basic steps to getting OpenACS up and running are:
-
-
-
- Install an OS (Linux, FreeBSD, OpenBSD, , , ).
-
-
- Install a database (
+ Basic Steps
+
+
+ The basic steps to getting OpenACS up and running are:
+
+
+
+ Install an OS (Linux, FreeBSD, OpenBSD, , , ).
+
+
+ Install a database (Oracle or
- PostgreSQL).
-
+ PostgreSQL).
+
-
- Install the AOLserver webserver.
-
-
- Create a unique database and system user.
- Install the OpenACS tarball, start and AOLserver instance, and
- use the OpenACS web pages to complete installation
- ().
-
-
-
-
- Binaries and other shortcuts
-
-
- The patched version of AOLserver we use is not currently
- available in a precompiled binary.
-
-
-
- The packaged version of
- PostgreSQL in Debian and Red Hat and FreeBSD ports works fine.
-
-
- Jonathan Marsden has created RPMs (at
- http://www.xc.org)
- for OpenACS 4.5 but there are not yet any for version
- &version;.
-
-
- An experimental script automates OpenACS checkout and
- installation.
-
-
-
-
-
-
- Requirements
+
+ Install the AOLserver webserver.
+
+
+ Create a unique database and system user.
+ Install the OpenACS tarball, start and AOLserver instance, and
+ use the OpenACS web pages to complete installation
+ ().
+
+
+
+
+
+ Binaries and other shortcuts
+
+
+
+ The patched version of AOLserver we use is not currently
+ available in a precompiled binary.
+
+
- You will need a PC (or equivalent) with at least these minimum
- requirements:
-
-
- Pentium processor
- 128 MB RAM
- (much more if you want Oracle)
- 4 GB hard drive
- A Unix-like operating system with tcl, tdom, and
- a mail transport agent. ()
-
-
- All of the software that you will need is free and open-source,
- except for Oracle. You can obtain a free copy of Oracle for
- development purposes. This is described in the section.
-
-
-
- At the time of writing AOLserver 4.0 has been tested with OpenACS and works but has not been used in
- production. OpenACS 5.0.0 installs successfully on PostgreSQL 7.4 and Oracle 9i but not all packages
- outside core have been tested.
-
-
+
+ Requirements
+
+ You will need a PC (or equivalent) with at least these minimum
+ requirements:
+
+
+ Pentium processor
+ 128 MB RAM
+ (much more if you want Oracle)
+ 4 GB hard drive
+ A Unix-like operating system with tcl, tdom, and
+ a mail transport agent. ()
+
+
+ All of the software that you will need is free and open-source,
+ except for Oracle. You can obtain a free copy of Oracle for
+ development purposes. This is described in the section.
+
-
- How to use this guide
-
-
- This is text you will see on
- screen, such as a Button or link
- in a radio button list or menu.
-
- This is text that you will type.
-
- This is text from a program or file which you may need to
-examine or edit:
- if {$database == "oracle"} {
- set db_password "mysitepassword"
-}
-
-
- This is text that you will
-see and type in a command shell, including text you may have to
-change. It is followed by a list of just the commands,
-which you can copy and paste.
- [root@localhost root]# su - nsadmin
-[nsadmin@localhost aolserver]$ svc -d /service/server1
-[nsadmin@localhost aolserver]$ dropdb server1
-DROP DATABASE
-[nsadmin@localhost aolserver]$ createdb server1
-CREATE DATABASE
-su - nsadmin
-svc -d /service/server1
-dropdb server1
-createdb server1
-
-
+
+
+
+
+ At the time of writing AOLserver 4.0 has been tested with OpenACS and works but has not been used in
+ production. OpenACS 5.0.0 installs successfully on PostgreSQL 7.4 and Oracle 9i but not all packages
+ outside core have been tested.
+
-
- Paths and Users
-
-
-
- None of these locations are set in stone - they're simply
- the values that we've chosen. The values that you'll
- probably want to change, such as service name, are
- marked like this. The other
- values we recommend you leave unchanged unless you have a
- reason to change them.
-
-
-
- Some of the paths and user accounts have been changed from
- those recommended in previous versions of this document to
- improve security and maintainability. See
+ None of these locations are set in stone - they're simply
+ the values that we've chosen. The values that you'll
+ probably want to change, such as service name, are
+ marked like this. The other
+ values we recommend you leave unchanged unless you have a
+ reason to change them.
+
+
+
+ Some of the paths and user accounts have been changed from
+ those recommended in previous versions of this document to
+ improve security and maintainability. See this
- thread for discussion.
-
-
+ thread for discussion.
+
-
-
+
-
- Getting Help during installation
-
-
- We'll do our best to assure that following our instructions will get
- you to the promised land. If something goes wrong, don't
- panic. There are plenty of ways to get help. Here are some tips:
-
-
-
-
- Keep track of the commands you are run and record their output. I
- like to do my installations in a shell inside of emacs
- (M-x shell) so that I can save
- the output if needed. An alternative would be to use the
- script command.
-
-
+
+ Getting Help during installation
-
-
- We'll point out where the error logs for the various pieces of
- software are. Output from those logs will help us help you. Don't
- worry if you feel overwhelmed by all the information in the error
- logs. Over time, you'll find that they make more and more
- sense. Soon, you'll actually look forward to errors so that you
- can run to the log and diagnose the problem.
-
-
+
+ We'll do our best to assure that following our instructions will get
+ you to the promised land. If something goes wrong, don't
+ panic. There are plenty of ways to get help. Here are some tips:
+
-
-
- Search the forums at
- openacs.org - you'll often find many people who have
- struggled through the same spot that you're in.
-
-
+
+
+
+ Keep track of the commands you are run and record their output. I
+ like to do my installations in a shell inside of emacs
+ (M-x shell) so that I can save
+ the output if needed. An alternative would be to use the
+ script command.
+
+
-
-
- The bottom of each page has a link to OpenACS.org, where you can post
- comments and read other users comments about the
- contents of the page.
-
-
+
+
+ We'll point out where the error logs for the various pieces of
+ software are. Output from those logs will help us help you. Don't
+ worry if you feel overwhelmed by all the information in the error
+ logs. Over time, you'll find that they make more and more
+ sense. Soon, you'll actually look forward to errors so that you
+ can run to the log and diagnose the problem.
+
+
-
-
- Ask questions at the irc channel on freenode.net
- (#openacs). They're knowledgeable and quite friendly
- if you can keep them on topic.
-
-
+
+
+ Search the forums at
+ openacs.org - you'll often find many people who have
+ struggled through the same spot that you're in.
+
+
-
-
- Post a question on the forums. Make sure
- you've done a search first. When you do post, be sure to include
- your setup information (OS, etc) as well as the exact commands
- that are failing with the accompanying error. If
- there's a SQL error in the TCL error or in the log,
- post that too.
-
-
+
+
+ The bottom of each page has a link to OpenACS.org, where you can post
+ comments and read other users comments about the
+ contents of the page.
+
+
-
-
- If you find errors in this document or if you have ideas about
- making it better, please post them in our
- BugTracker.
+
+
+ Ask questions at the irc channel on freenode.net
+ (#openacs). They're knowledgeable and quite friendly
+ if you can keep them on topic.
-
-
- ($Id: overview.xml,v 1.12 2003/10/28
- 22:07:41 joela Exp $)
+
-
-
+
+
+ Post a question on the forums. Make sure
+ you've done a search first. When you do post, be sure to include
+ your setup information (OS, etc) as well as the exact commands
+ that are failing with the accompanying error. If
+ there's a SQL error in the TCL error or in the log,
+ post that too.
+
+
+
+
+ If you find errors in this document or if you have ideas about
+ making it better, please post them in our
+ BugTracker.
+
+
+
+ ($Id$)
+
-
+