Re: [racket-users] Scribble: unnumbered and unindexed sections
Just as a note of warning to other readers. I like being able to use #:tag for sections to get human-readable file/directory names. Unfortunately, using the tag prefixes also affects these names. For instance, if you use #:tag "foo", you get a file named "foo.html". But if you use #:tag-prefixes "foo" as well, then you end up with "foofoo.html", which can look very strange. There's probably another flag to fix this too, but I haven't found it yet. (-: Shriram -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble: unnumbered and unindexed sections
Thanks all for the help.
To summarize for the benefit of those who find this thread later:
A style of 'unnumbered does the trick. Thus
@section[#:style 'unnumbered]{My Section}
will list it without giving it a number.
As for avoiding duplicate tags, this doesn't appear to be quite right:
> If you go the latter route, you'll also need to use `#:tag-prefix` in a
> cross-reference to a subsection (if you have any besides "Handin
> Instructions") in one of the N sections.
>
It appears that the actual keyword argument is #:tag-prefixes [note extra
"es"], and it takes a list of tags.
Thus, with only one prefix, a source document with
@section[#:tag "uniq" #:tag-prefix "uniq"]{My Section}
can be referenced as
(secref #:tag-prefixes (list "uniq") "uniq")
[But of course there's no reason for the tag and the tag-prefix to be the
same string.]
And of course you can combine these:
@section[#:style 'unnumbered #:tag "uniq" #:tag-prefix "uniq"]{My Section}
Shriram
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble: unnumbered and unindexed sections
Besides `#:style 'unnumbered` as William says, to avoid the duplicate key warnings, you more or less have to cons up a new name --- but it doesn't have to be a visibly distinct section name. You can either * use `#:tag "HandinX"` with a different "X" for each "Handin Instructions" section, or * use `#:tag-prefix "X"` with a different "X" for each of the N sections. If you go the latter route, you'll also need to use `#:tag-prefix` in a cross-reference to a subsection (if you have any besides "Handin Instructions") in one of the N sections. At Sun, 4 Sep 2016 11:50:21 -0700 (PDT), Shriram Krishnamurthi wrote: > Is there a way to have unnumbered and unindexed section? (Yes, these are > different issues.) > > It would be helpful to have unnumbered sections, à la \[sub]section* in LaTeX. > > It would be especially helpful to have unindexed sections. The real nuisance > I'm trying to avoid is, say I have N sections that each have a subsection > named "Handin Instructions". Then I get a bunch of Scribble warnings due to > the duplicate section name. Since I have no desire to link to these sections, > I don't need them indexed at all. And this way I don't have to cons up new > names for each of them (though I do of course have that option…). > > Thanks. > > -- > You received this message because you are subscribed to the Google Groups > "Racket Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to racket-users+unsubscr...@googlegroups.com. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
RE: [racket-users] Scribble: unnumbered and unindexed sections
Would this do what you want?
#lang scribble/base
@section{a}
@subsubsub*section{a}
@subsubsub*section{a}
@subsubsub*section{a}
@section{b}
@seclink["a" "section a"]
@subsubsub*section{b}
@subsubsub*section{b}
@subsubsub*section{b}
@section{b}
@subsubsub*section{b}
@subsubsub*section{b}
@subsubsub*section{b}
Jos
-Original Message-
From: racket-users@googlegroups.com [mailto:racket-users@googlegroups.com] On
Behalf Of Shriram Krishnamurthi
Sent: domingo, 04 de septiembre de 2016 20:50
To: Racket Users
Subject: [racket-users] Scribble: unnumbered and unindexed sections
Is there a way to have unnumbered and unindexed section? (Yes, these are
different issues.)
It would be helpful to have unnumbered sections, à la \[sub]section* in LaTeX.
It would be especially helpful to have unindexed sections. The real nuisance
I'm trying to avoid is, say I have N sections that each
have a subsection named "Handin Instructions". Then I get a bunch of Scribble
warnings due to the duplicate section name. Since I
have no desire to link to these sections, I don't need them indexed at all. And
this way I don't have to cons up new names for each
of them (though I do of course have that option…).
Thanks.
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Re: [racket-users] Scribble: unnumbered and unindexed sections
On Sun, Sep 04, 2016 at 11:50:21AM -0700, Shriram Krishnamurthi wrote:
> Is there a way to have unnumbered and unindexed section? (Yes, these are
> different issues.)
>
> It would be helpful to have unnumbered sections, à la \[sub]section* in LaTeX.
You can use `@section[#:style 'unnumbered]` for this.
See `raco doc part` for some of the relevant style names. I'm not sure, but one
of them ('hidden ?) may help with unindexed.
--
William J. Bowman
--
You received this message because you are subscribed to the Google Groups
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
signature.asc
Description: PGP signature
[racket-users] Scribble: unnumbered and unindexed sections
Is there a way to have unnumbered and unindexed section? (Yes, these are different issues.) It would be helpful to have unnumbered sections, à la \[sub]section* in LaTeX. It would be especially helpful to have unindexed sections. The real nuisance I'm trying to avoid is, say I have N sections that each have a subsection named "Handin Instructions". Then I get a bunch of Scribble warnings due to the duplicate section name. Since I have no desire to link to these sections, I don't need them indexed at all. And this way I don't have to cons up new names for each of them (though I do of course have that option…). Thanks. -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
