Hi Andreas, Many thanks for your detailed reply. As it happens I use Knoppix and should be able to apt-get the latest version of the Zope Book - I didn't know it was available in this format. Many thanks, Cormac. Andreas Tille wrote:
On Fri, 2 Apr 2004, Cormac McClean wrote:
However, now that I'm beginning development, I need up to date documentation. I have a copy of the Zope Book V2.6 pdf, but I'm wondering how useful it will be given that the current version of Zope is 2.7.
I'm not sure whether the PDF is a daily build, however for building the Debian packages I check out the "source" with the script appended to the end of this mail. If you apply the diff available at
http://ftp.debian.org/debian/pool/main/z/zope-book/zope-book_20040401-1.diff...
you have all things to build your own plain HTML or PDF even if not using Debian GNU/Linux, where 'apt-get install zope-book' is enough. It was updated yesterday by chance...
Also, the Zope Developers Guide on zope.org is version 2.4. Am I right in thinking that this is a guide for Zope 2.4, rather than version 2.4 of the Guide? Perhaps the ZDG has been incorporated into versino 2.6 of the Zope Book?
I think not and it's a shame that it is this outdated.
I have a similar question regarding the Zope Administrator's Guide Project. The project has stalled since Jan 2002, according to http://zope.org/DocProjects/AdminGuide/Project/FrontPage
I think it is even worse.
Kind regards
Andreas.
#!/bin/sh ## Script to obtain current zope book stx + images
NAME=zope-book MAINBASE=zope.org/Documentation/Books/ZopeBook/2_6Edition MAIN=http://www.${MAINBASE} URLS=http://${MAINBASE}
DATE=`date +%Y%m%d` DIR=${NAME}-${DATE} TAR=${DIR}.tar.gz
mkdir -p ${DIR} cd ${DIR}
# get stx # wget -N http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/index_html # wget -N http://zope.org/Documentation/Books/ZopeBook/2_6Edition/ wget -N -q http://www.zope.org/Documentation/Books/ZopeBook/current mv view index_html echo "Downloading stx-files ..." cat index_html | \ grep "\.stx" | \ sed -e "s?^.*\(http://\)?echo -n '.'; wget -N -q \1?" \ -e "s?\([^/]*\.stx\).*?\1/document_src; mv document_src \1?" | \ cat > getstx chmod 755 getstx ./getstx rm getstx echo ""
for stx in `ls *.stx` ; do # remove ^M and backtalk comments mv ${stx} ${stx}~ cat ${stx}~ | \ perl -pe 's/\r//g' | \ sed "/^[[:space:]]\+% [[:alnum:][:space:]_]\+ - [[:alnum:]]\{3,4\}\.* [0-9]\+, [0-9]\{4\} [0-9]\+:[0-9]\+/,/^$/d" | \ cat > ${stx} rm ${stx}~ done
if grep -q "^[[:space:]]\+% " *.stx ; then echo "Some remaing comments found ..." grep "^[[:space:]]\+% " *.stx fi
# get figures fig=Figures
mkdir -p ${fig} grep "img" *.stx > ${fig}/imgs cd ${fig} cat imgs | \ grep ${fig} | \ sed -e "s?^.*\(${fig}\)/?echo -n '.'; wget -N -q ${MAIN}/\1/?" | \ sort | uniq | \ cat > figures
chmod 755 figures echo "Downloading images ..." ./figures echo "" rm imgs figures
if file -b -i * | sort | uniq | grep -q -v "^image" ; then echo "It seems that there where some files downloaded which are no images ..." file -i * | sort | grep -v ":[[:space:]]\+image" echo "I'm going to move these files to directory Non-${fig}." mkdir ../Non-${fig} ## some strange characters avoid propper moving so fix this first ... mv login_form* ../Non-${fig} for nonimg in `file -i * | grep -v ":[[:space:]]\+image" | sed "s/:.*//"` ; do mv "$nonimg" ../Non-${fig} done fi cd ..
# get css and js #grep "http.*backtalk" index_html | \ # grep -v backtalk.book_pdf_form | \ # grep -v backtalk.book_view | \ # sed -e "s?^.*[fc]=\"\(.*\)\".*?wget -N \1?" \ # -e "s/.*\(backtalk\)_\(.*\)/&; mv \1_\2 \1.\2/" | \ # uniq | \ #cat > getstyle # #grep "\.css\"" index_html | \ # sed -e "s?^.*[fc]=\"\(.*\)\".*?wget -N \1?" | \ #cat >> getstyle #chmod 755 getstyle # #./getstyle #[ -s plonePrint.css ] && ln -s plonePrint.css backtalk.css #rm ./getstyle wget -N -q http://zope.org/plone.css
# get Zope button image wget -N -q http://www.zope.org/p_/ZopeButton mv ZopeButton ZopeButton.jpg
# prepare index.html cat index_html | \ sed -e "s?${URLS}/\(.*\.\)stx?\1html?g" \ -e "s?${URLS}/\(backtalk\)_?\1.?" | \ perl -ne '$f=1; chomp; s/\r//; print "$_\n" ; while (<>) { chomp; s/\r//; if ($f) { print "$_\n"; if (/<body>/) {$f=0 ;} } if (!$f) { if (/<b>The Zope Book/) { print "$_\n"; } if (/<table class="listing">/) { $f=1; } } }' | \ sed -e "/<thead>/,/<.thead>/d" \ -e "s/<tbody>/<table>/" \ -e "/<base href=\"http:/d" \ -e "/<\/tbody>/d" | \ perl -ne '$f=1; chomp; print "$_\n" ; while (<>) { if ($f) { print "$_\n"; if (?</table>?) {$f=0 ;} } if (!$f && ?</body>?) { print "$_\n"; $f=1; } }' | \ perl -ne '$f=1; chomp; print "$_\n" ; while (<>) { if ($f) { print "$_\n"; if (?</title>?) {$f=0 ;} } if (!$f && ?</head>?) { print "<link rel=\"StyleSheet\" href=\"plone.css\" type=\"text/css\">\n" ; print "$_\n"; $f=1; } }' | \ cat > index.html
rm index_html
cd ..
tar -czf ${TAR} ${DIR}
_______________________________________________ Zope maillist - Zope@zope.org http://mail.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://mail.zope.org/mailman/listinfo/zope-announce http://mail.zope.org/mailman/listinfo/zope-dev )
______________________________________________________________________ This email has been scanned by the MessageLabs Email Security System. For more information please visit http://www.messagelabs.com/email ______________________________________________________________________
______________________________________________________________________ This email has been scanned by the MessageLabs Email Security System. For more information please visit http://www.messagelabs.com/email ______________________________________________________________________