From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ralf Angeli Newsgroups: gmane.emacs.devel Subject: Re: Online Emacs Manuals at gnu.org Date: Mon, 11 Jun 2007 00:13:20 +0200 Message-ID: <877iqb1mrj.fsf@neutrino.caeruleus.net> References: <871wgkoe4o.GNU's_Not_Unix!%yavor@gnu.org> <87hcpfldkd.fsf@stupidchicken.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: sea.gmane.org 1181513614 31282 80.91.229.12 (10 Jun 2007 22:13:34 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 10 Jun 2007 22:13:34 +0000 (UTC) Cc: karl@gnu.org, yavor@gnu.org, emacs-devel@gnu.org To: Chong Yidong Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 11 00:13:32 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1HxVf9-0003I1-NU for ged-emacs-devel@m.gmane.org; Mon, 11 Jun 2007 00:13:31 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HxVf8-0005Ye-Of for ged-emacs-devel@m.gmane.org; Sun, 10 Jun 2007 18:13:30 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HxVf6-0005YN-DZ for emacs-devel@gnu.org; Sun, 10 Jun 2007 18:13:28 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HxVf5-0005Y0-Nm for emacs-devel@gnu.org; Sun, 10 Jun 2007 18:13:27 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HxVf5-0005Xv-Ko for emacs-devel@gnu.org; Sun, 10 Jun 2007 18:13:27 -0400 Original-Received: from moutng.kundenserver.de ([212.227.126.174]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1HxVf1-0004NM-BJ; Sun, 10 Jun 2007 18:13:23 -0400 Original-Received: from [84.165.40.201] (helo=neutrino.caeruleus.net) by mrelayeu.kundenserver.de (node=mrelayeu7) with ESMTP (Nemesis), id 0ML2xA-1HxVez1xBe-0000re; Mon, 11 Jun 2007 00:13:22 +0200 In-Reply-To: <87hcpfldkd.fsf@stupidchicken.com> (Chong Yidong's message of "Sun, 10 Jun 2007 17:11:46 -0400") User-Agent: Gnus/5.110007 (No Gnus v0.7) Emacs/22.1.50 (gnu/linux) X-Provags-ID: V01U2FsdGVkX19fD9Y2JT+qKVg0mn8v4rjw+UBnU+mzRYRHZfW FfJR+o5N6ZEmMeRXmqRtEiO7ElC6FUgsXp47LBgEl0Tez2iFUK cqdoeK9JS6wm7qbkWEBxA== X-detected-kernel: Linux 2.6? (barebone, rare!) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:72592 Archived-At: --=-=-= * Chong Yidong (2007-06-10) writes: > In order to get the links to work properly without lots of symlink > hacking, I had to move the existing manual files around so that they > are where "makeinfo --html" expects. Thus, the "entirely on one > webpage" version of the emacs manual is now in > manual/html_mono/emacs.html instead of manual/emacs.html, the index > page for the Emacs manual has been moved from manual/index.html to > manual/emacs.html, and the elisp manual has also been merged into the > manual/ tree. We have a similar setup with AUCTeX, preview-latex, and RefTeX. You can see that in action at . I set this up by patching gendocs.sh (see attachment; not sure if this will apply cleanly) and using a htmlxref.cnf file for managing the cross references. It would be nice if gendocs.sh would support a setup with multiple manuals in one `manual' directory by default. -- Ralf --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=gendocs.sh.patch --- /usr/src/reftex/prog/reftex/gendocs.sh~ 2007-04-11 19:35:34 +0200 +++ /usr/src/reftex/prog/reftex/gendocs.sh 2007-04-11 19:28:59 +0200 @@ -32,6 +32,7 @@ : ${SETLANG="env LANG= LC_MESSAGES= LC_ALL= LANGUAGE="} : ${MAKEINFO="makeinfo"} +: ${TEXI2HTML="texi2html"} : ${TEXI2DVI="texi2dvi -t @finalout"} : ${DVIPS="dvips"} : ${DOCBOOK2HTML="docbook2html"} @@ -195,7 +196,7 @@ ascii_gz_size=`calcsize $outdir/$PACKAGE.txt.gz` mv $PACKAGE.txt $outdir/ -cmd="$SETLANG $MAKEINFO --no-split --html -o $PACKAGE.html $html \"$srcfile\"" +cmd="$SETLANG $TEXI2HTML -o $PACKAGE.html $html \"$srcfile\"" echo "Generating monolithic html... ($cmd)" rm -rf $PACKAGE.html # in case a directory is left over eval "$cmd" @@ -204,7 +205,7 @@ html_mono_gz_size=`calcsize $outdir/$PACKAGE.html.gz` mv $PACKAGE.html $outdir/ -cmd="$SETLANG $MAKEINFO --html -o $PACKAGE.html $html \"$srcfile\"" +cmd="$SETLANG $TEXI2HTML --split=node --use-nodes --node-files --top-file=\"index.html\" -o $PACKAGE.html $html \"$srcfile\"" echo "Generating html by node... ($cmd)" eval "$cmd" split_html_dir=$PACKAGE.html @@ -213,9 +214,9 @@ tar -czf ../$outdir/${PACKAGE}.html_node.tar.gz -- *.html ) html_node_tgz_size=`calcsize $outdir/${PACKAGE}.html_node.tar.gz` -rm -f $outdir/html_node/*.html -mkdir -p $outdir/html_node/ -mv ${split_html_dir}/*.html $outdir/html_node/ +rm -f $outdir/${PACKAGE}/*.html +mkdir -p $outdir/${PACKAGE}/ +mv ${split_html_dir}/*.html $outdir/${PACKAGE}/ rmdir ${split_html_dir} echo Making .tar.gz for sources... @@ -290,7 +291,7 @@ -e "s!%%DOCBOOK_XML_GZ_SIZE%%!$docbook_xml_gz_size!g" \ -e "s,%%SCRIPTURL%%,$scripturl,g" \ -e "s!%%SCRIPTNAME%%!$prog!g" \ -$GENDOCS_TEMPLATE_DIR/gendocs_template >$outdir/index.html +$GENDOCS_TEMPLATE_DIR/gendocs_template >$outdir/${PACKAGE}.index.html echo "Done! See $outdir/ subdirectory for new files." --=-=-= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-devel --=-=-=--