Index: openacs-4/packages/acs-core-docs/www/packages.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/packages.adp,v diff -u -r1.6 -r1.7 --- openacs-4/packages/acs-core-docs/www/packages.adp 18 Apr 2018 08:07:33 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/packages.adp 25 Apr 2018 08:38:28 -0000 1.7 @@ -3,11 +3,11 @@ OpenACS Packages -
+ leftLink="dev-guide" leftLabel="Prev" + title="Chapter 11. Development +Reference" + rightLink="objects" rightLabel="Next"> +

OpenACS Packages

<authorblurb>

By Pete Su and Bryan Quinn

</authorblurb>

@@ -22,11 +22,11 @@

Server file layout

Here is how an OpenACS 5 server is laid out starting from the Server root (ROOT):

-

Figure 11.1. Server file layout +

Figure 11.1. Server file layout diagram

 ROOT/
     bin/
-        Various executables and scripts for server maintanence.
+        Various executables and scripts for server maintenance.
     content-repository-content-files/
         content repository content stored in the filesystem.
     etc/
@@ -41,8 +41,7 @@
     tcl/
         bootstrap code
     www/
-        Pages not in packages (static content, customized pages)
-
+ Pages not in packages (static content, customized pages)


@@ -62,7 +61,7 @@ To illustrate the general structure of a package, let's see what the package for the "notes" application should look like.

-

Figure 11.2. Package file layout +

Figure 11.2. Package file layout diagram

 ROOT/
   +-- packages/    APM Root
@@ -120,8 +119,7 @@
         |     |     +-- *.adp                             UI Templates
         |     |     +-- *-oracle.xql                      Oracle-specific Queries
         |     |     +-- *-postgresql.xql                  PostgreSQL-specific Queries
-        +-- Other package directories.
-
+ +-- Other package directories.


All file locations are relative to the package root, which in this case is ROOT/packages/notes. The following table describes in detail what each of the files up in the diagram @@ -133,7 +131,7 @@ .tcl or .adp files are not sourced in these directories. This makes it suitable for storing icons, css files, javascript, and other static content which can be treated this way.

-

Table 11.1. Package +

Table 11.1. Package files

@@ -324,8 +322,7 @@ this point, you should add your package files to your CVS repository. I'll assume that you have set up your development repository according to the standards described in this appendix. If so, then -you just do this:

-% cd ROOT/packages
+you just do this:

% cd ROOT/packages
 % cvs add notes
 % cd notes
 % cvs add notes.info
@@ -334,8 +331,7 @@
 % cvs add *.sql
 % cd ROOT/packages/notes
 % cvs commit -m "add new package for notes"
-    
-
+
  • Now you can start developing the package. In addition to writing code, you should also consider the tasks outlined in the package development tutorial.

  • @@ -398,15 +394,15 @@ Additional Reading

    ($‌Id: packages.xml,v 1.10 2017/08/07 -23:47:54 gustafn Exp $)

    +

    ($‌Id: packages.xml,v 1.13 2018/04/22 +19:24:37 gustafn Exp $)

    - + homeLink="index" homeLabel="Home" + upLink="dev-guide" upLabel="Up"> + \ No newline at end of file