Path: ...!news.misty.com!weretis.net!feeder9.news.weretis.net!news.nk.ca!rocksolid2!i2pn2.org!.POSTED!not-for-mail
From: berg@typoscriptics.de (TorstenBerg)
Newsgroups: comp.lang.tcl
Subject: Re: Sample markup documentation file for a Tcl/Tk package
Date: Fri, 24 Jan 2025 08:24:46 +0000
Organization: novaBBS
Message-ID: <79d41b0380599879b5f84334b407f363@www.novabbs.com>
References: <vmloku$30le9$1@dont-email.me> <87sepaev0t.fsf@pointsman.de> <vmtl7h$1h979$2@dont-email.me>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Info: i2pn2.org;
	logging-data="884998"; mail-complaints-to="usenet@i2pn2.org";
	posting-account="xPTk8ic+ltIs4SDkCn9Fp7eV+RMOfXYjsd4WptzKKdI";
User-Agent: Rocksolid Light
X-Rslight-Posting-User: a57e9dbaf481589bcf993cc1252a6f6a094c850c
X-Spam-Checker-Version: SpamAssassin 4.0.0
X-Rslight-Site: $2y$10$Cx3dHdTtmQL98umeHGr8P.4H8qHVZUbbQyv8OlDY2eva.D9YH.fhm
Bytes: 1701
Lines: 27

Hi,

what did you use to produce the HTML with? For TIP 700, I propose Pandoc
for now as we do not yet have our own Tcl library that is capable of all
the markdown constructs we would like to have.

Especially the `[string]{.optarg}` construct you mention is not possible
to render with e.g. the tcllib markdown module as it is a Pandoc
markdown syntax element.

If you need to render it with Pandoc, you have to specify the
corresponding CSS element (Pandoc translates `.optarg` into a CSS class)
which could look like this (untested):

optarg {
  font-style: italic;

  &:before {
    content: '?';
  }

  &:after {
    content: '?';
  }
}


Regards, Torsten