goba Sat Jun 26 11:24:33 2004 EDT
Added files:
/phpdoc/dsssl howto-php.dsl.in
Modified files:
/phpdoc Makefile.in
/phpdoc/RFC 2003_meeting_findings.txt
/phpdoc/dsssl .cvsignore
Log:
PHP version of the dochowto for the docweb site, plus update the 2003 meeting report
http://cvs.php.net/diff.php/phpdoc/Makefile.in?r1=1.149&r2=1.150&ty=u
Index: phpdoc/Makefile.in
diff -u phpdoc/Makefile.in:1.149 phpdoc/Makefile.in:1.150
--- phpdoc/Makefile.in:1.149 Thu Apr 29 11:19:26 2004
+++ phpdoc/Makefile.in Sat Jun 26 11:24:33 2004
@@ -16,7 +16,7 @@
#
#
-# $Id: Makefile.in,v 1.149 2004/04/29 15:19:26 nlopess Exp $
+# $Id: Makefile.in,v 1.150 2004/06/26 15:24:33 goba Exp $
#
all: html
@@ -42,6 +42,7 @@
HTML_STYLESHEET=dsssl/html.dsl
PHPWEB_STYLESHEET=dsssl/phpweb.dsl
HOWTO_STYLESHEET=dsssl/howto.dsl
+HOWTOPHP_STYLESHEET=dsssl/howto-php.dsl
PRINT_STYLESHEET=dsssl/print.dsl
QUICKREF_STYLESHEET=dsssl/quickref.dsl
KDEVELOP_TOC_STYLESHEET=dsssl/kdevelop_toc.dsl
@@ -51,7 +52,7 @@
BIGHTML_DEPS=$(HTML_STYLESHEET) dsssl/html-common.dsl dsssl/html-locale.dsl.in
dsssl/common.dsl.in zendapi
HTML_DEPS=$(HTML_STYLESHEET) dsssl/html-common.dsl dsssl/html-locale.dsl.in
dsssl/common.dsl.in zendapihtml
-HOWTO_DEPS=$(HOWTO_STYLESHEET) dsssl/html-common.dsl dsssl/html-locale.dsl.in
dsssl/common.dsl.in howto/howto.ent
+HOWTO_DEPS=$(HOWTO_STYLESHEET) $(HOWTOPHP_STYLESHEET) dsssl/html-common.dsl
dsssl/html-locale.dsl.in dsssl/common.dsl.in howto/howto.ent
PRINT_DEPS=$(PRINT_STYLESHEET) dsssl/common.dsl.in dsssl/print.dsl.in zendapi
PHPWEB_DEPS=$(PHPWEB_STYLESHEET) dsssl/html-common.dsl dsssl/common.dsl zendapiphp
KDEVELOP_TOC_DEPS=dsssl/kdevelop_toc.dsl Makefile
@@ -98,6 +99,7 @@
ps: @[EMAIL PROTECTED]
pdf: @[EMAIL PROTECTED]
howto: howto/html/index.html
+howtophp: howto/php/index.php
howtotgz: howto/howto.html.tar.gz
funcindex: funcindex.xml
revcheck: revcheck.html
@@ -219,6 +221,10 @@
@[EMAIL PROTECTED]: html/index.html
-rm -f $@ && (cd html; tar -cf - *.html @FIGURES@) | bzip2 -9 > $@
+howto/php/index.php: howto/howto.xml $(HOWTO_DEPS)
+ @test -d howto/php || mkdir howto/php
+ -$(JADE) -i lang-en $(CATALOG) -d $(HOWTOPHP_STYLESHEET) -V use-output-dir -t
sgml $(XMLDCL) $(srcdir)/howto/howto.xml
+
howto/html/index.html: howto/howto.xml $(HOWTO_DEPS)
@test -d howto/html || mkdir howto/html
-$(JADE) -i lang-en $(CATALOG) -d $(HOWTO_STYLESHEET) -V use-output-dir -t
sgml $(XMLDCL) $(srcdir)/howto/howto.xml
@@ -302,7 +308,7 @@
# {{{ cleanup
clean:
- rm -rf html php fancy figures howto/html
+ rm -rf html php fancy figures howto/html howto/php
rm -f @[EMAIL PROTECTED] [a-z]*.html @[EMAIL PROTECTED] manual.info
rm -f @[EMAIL PROTECTED] @[EMAIL PROTECTED] .manual.xml
rm -f manual_*.pdb @srcdir@/scripts/makedoc *.manifest
http://cvs.php.net/diff.php/phpdoc/RFC/2003_meeting_findings.txt?r1=1.2&r2=1.3&ty=u
Index: phpdoc/RFC/2003_meeting_findings.txt
diff -u phpdoc/RFC/2003_meeting_findings.txt:1.2
phpdoc/RFC/2003_meeting_findings.txt:1.3
--- phpdoc/RFC/2003_meeting_findings.txt:1.2 Wed Feb 18 11:06:47 2004
+++ phpdoc/RFC/2003_meeting_findings.txt Sat Jun 26 11:24:33 2004
@@ -332,6 +332,8 @@
fix errors in the docs / translation or add examples). In case of translations,
the group should ask those working on the translation too.
+ > DONE (by Derick)
+
11. Misc notes
------------------------------------------------------------------------------
http://cvs.php.net/diff.php/phpdoc/dsssl/.cvsignore?r1=1.1&r2=1.2&ty=u
Index: phpdoc/dsssl/.cvsignore
diff -u phpdoc/dsssl/.cvsignore:1.1 phpdoc/dsssl/.cvsignore:1.2
--- phpdoc/dsssl/.cvsignore:1.1 Mon Jan 7 04:54:37 2002
+++ phpdoc/dsssl/.cvsignore Sat Jun 26 11:24:33 2004
@@ -1,5 +1,6 @@
common.dsl
howto.dsl
+howto-php.dsl
html-locale.dsl
html.dsl
install.dsl
http://cvs.php.net/co.php/phpdoc/dsssl/howto-php.dsl.in?r=1.1&p=1
Index: phpdoc/dsssl/howto-php.dsl.in
+++ phpdoc/dsssl/howto-php.dsl.in
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY docbook.dsl SYSTEM "@DOCBOOK_HTML@" CDATA DSSSL>
<!ENTITY html-common.dsl SYSTEM "@srcdir@/html-common.dsl">
<!ENTITY version.dsl SYSTEM "@srcdir@/version.dsl">
<!-- these files are generated, so they are not in @srcdir@ -->
<!ENTITY html-locale.dsl SYSTEM "html-locale.dsl">
<!ENTITY common.dsl SYSTEM "common.dsl">
]>
<!--
$Id: howto-php.dsl.in,v 1.1 2004/06/26 15:24:33 goba Exp $
HTML-specific stylesheet customization for the PHPDOC howto.
-->
<style-sheet>
<style-specification id="docbook-php-html" use="docbook">
<style-specification-body>
(define %html-ext% ".php")
(define %output-dir% "howto/php")
(define %generate-article-toc%
;; Should a Table of Contents be produced for Articles?
#t)
;; Uncommented, because generates a warning
;;(define (toc-depth nd)
;; 2)
(define %section-autolabel%
;; Are sections enumerated?
#t)
;; Retrieves a node's title from the XML source. Parameters are
;; the current node and title element's name (unused)
(define (docweb-node-title #!optional (nd (current-node)) (title-elem "title"))
(let*
(
(preferred-title-node
(cond
;; For "refentry"s search for the first (and
only one)
;; "refname" from the children list of
"refnamediv" childrens.
(
(equal? (gi nd) "refentry")
(node-list-first
(select-elements
(children
(select-elements (children nd) "refnamediv")
)
"refname"
)
)
)
;; For other nodes, just select the first
children node
(else
(node-list-first
(select-elements (children nd)
title-elem)
)
)
)
)
;; The title node is the preferred title node, or if
;; it cannot be find, then then "title" children
(title-node
(if (node-list-empty? preferred-title-node)
(select-elements (children nd) "title")
preferred-title-node
)
)
)
(data title-node)
)
)
;; Quotes a string to be inserted to a single quoted string
(define (docweb-quote str)
(string-replace str "'" "\\'")
)
;; Prints out a PHP file header. Parameter is the current node (unused)
(define (docweb-header #!optional (nd (current-node)))
(php-code
(string-append
newline
"include_once '../include/lib_general.inc.php';" newline
"echo site_header('" (docweb-quote (docweb-node-title nd))
"');" newline
)
)
)
;; Prints out manual footer PHP code. Parameter is the current node (unused)
(define (docweb-footer #!optional (nd (current-node)))
(php-code
(string-append
"echo site_footer();" newline
)
)
)
;; Defines the format of all the output files
;; generated for phpweb display. Parameters are the
;; title sequence and the body sequence.
(define (html-document title-sosofo body-sosofo)
(let
(
(doc-sosofo
(if (or (chunk?) (node-list=? (current-node)
(sgml-root-element)))
(make sequence
(docweb-header (current-node))
body-sosofo
(docweb-footer (current-node))
)
body-sosofo
)
)
)
(if (chunk?)
(make
entity
system-id: (html-entity-file (html-file))
doc-sosofo
)
doc-sosofo
)
)
)
&html-common.dsl;
&html-locale.dsl;
&common.dsl;
&version.dsl;
</style-specification-body>
</style-specification>
<external-specification id="docbook" document="docbook.dsl">
</style-sheet>
