Date: Tue, 20 Aug 2002 08:57:05 +0900 (JST) From: Hiroki Sato <hrs@jp.FreeBSD.org> To: keramida@FreeBSD.ORG Cc: friar_josh@webwarrior.net, doc@FreeBSD.ORG Subject: Re: docs/20028 ASCII docs should reflect <emphasis> tags Message-ID: <20020820.085705.106778583.hrs@eos.ocn.ne.jp> In-Reply-To: <20020819214526.GB3837@hades.hell.gr> References: <1029168527.229.27.camel@heater.vladsempire.net> <20020819214526.GB3837@hades.hell.gr>
next in thread | previous in thread | raw e-mail | index | archive | help
----Next_Part(Tue_Aug_20_08:57:05_2002_070)--
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Giorgos Keramidas <keramida@FreeBSD.ORG> wrote
in <20020819214526.GB3837@hades.hell.gr>:
keramida> On 2002-08-12 16:08 +0000, Josh Paetzel wrote:
keramida> > I'm willing to take a shot at tackling this, assuming it's a real
keramida> > problem that really needs fixing. It would also be nice to have some
keramida> > input as to what a good ASCII emphasis tag would be. The author of the
keramida> > pr suggests *this is emphasized*. Is that acceptable or is this subject
keramida> > to discussion/debate/flamages? :)
(snip)
keramida> This style of emphasizing looks okay. There will probably be problems
keramida> when one tries to emphasize a single `*' character, as in:
keramida>
keramida> <emphasis>*</emphasis>
Try the attached patch because the pr's one for w3m is obsolete,
even though it does not care when only a character "*" is enclosed
by <emphasis>.
However, I am anxious that this sort of decoration may
make readers confused.
-- Hiroki SATO <hrs@eos.ocn.ne.jp>
----Next_Part(Tue_Aug_20_08:57:05_2002_070)--
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Content-Disposition: inline; filename="doc_share.diff"
Index: doc/share/mk/doc.docbook.mk
===================================================================
RCS file: /home/ncvs/doc/share/mk/doc.docbook.mk,v
retrieving revision 1.68
diff -d -u -I\$FreeBSD:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.68 doc.docbook.mk
--- doc/share/mk/doc.docbook.mk 4 Jun 2002 11:40:17 -0000 1.68
+++ doc/share/mk/doc.docbook.mk 19 Aug 2002 23:23:23 -0000
@@ -161,6 +161,8 @@
HTMLOPTS?= -ioutput.html -d ${DSLHTML} ${HTMLFLAGS}
+HTMLTXTOPTS?= -ioutput.txt -ioutput.html -d ${DSLHTML} ${HTMLFLAGS}
+
PRINTOPTS?= -ioutput.print -d ${DSLPRINT} ${PRINTFLAGS}
.if defined(BOOK_OUTPUT)
@@ -420,7 +422,7 @@
# Special target to produce HTML with no images in it.
.if ${STYLESHEET_TYPE} == "dsssl"
${DOC}.html-text: ${SRCS} ${INDEX_SGML} ${HTML_INDEX}
- ${JADE} -V nochunks ${HTMLOPTS} \
+ ${JADE} -V nochunks ${HTMLTXTOPTS}\
${JADEOPTS} -t sgml ${MASTERDOC} > ${.TARGET} || \
(${RM} -f ${.TARGET} && false)
.elif ${STYLESHEET_TYPE} == "xsl"
Index: doc/share/sgml/freebsd.dsl
===================================================================
RCS file: /home/ncvs/doc/share/sgml/freebsd.dsl,v
retrieving revision 1.64
diff -d -u -I\$FreeBSD:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.64 freebsd.dsl
--- doc/share/sgml/freebsd.dsl 27 Feb 2002 04:56:44 -0000 1.64
+++ doc/share/sgml/freebsd.dsl 19 Aug 2002 23:55:57 -0000
@@ -3,6 +3,7 @@
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY % output.html "IGNORE">
<!ENTITY % output.html.images "IGNORE">
+<!ENTITY % output.txt "IGNORE">
<!ENTITY % output.print "IGNORE">
<!ENTITY % output.print.pdf "IGNORE">
<!ENTITY % output.print.justify "IGNORE">
@@ -23,6 +24,34 @@
(declare-flow-object-class formatting-instruction
"UNREGISTERED::James Clark//Flow Object Class::formatting-instruction")
+
+ <!-- TXT only ..................................................... -->
+
+ <![ %output.txt; [
+
+ (define %emtxt-bold-fence% "*")
+ (define %emtxt-italic-fence% "/")
+ (define %emtxt-bold-italic-fence% "_")
+
+ (define ($bold-seq$ #!optional (sosofo (process-children)))
+ (make sequence
+ (literal %emtxt-bold-fence%)
+ sosofo
+ (literal %emtxt-bold-fence%)))
+
+ (define ($italic-seq$ #!optional (sosofo (process-children)))
+ (make sequence
+ (literal %emtxt-italic-fence%)
+ sosofo
+ (literal %emtxt-italic-fence%)))
+
+ (define ($bold-italic-seq$ #!optional (sosofo (process-children)))
+ (make sequence
+ (literal %emtxt-bold-italic-fence%)
+ sosofo
+ (literal %emtxt-bold-italic-fence%)))
+ ]]>
+
<!-- HTML only .................................................... -->
----Next_Part(Tue_Aug_20_08:57:05_2002_070)----
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020820.085705.106778583.hrs>