ntg-context - mailing list for ConTeXt users
 help / color / mirror / Atom feed
From: Sietse Brouwer <sbbrouwer@gmail.com>
To: mailing list for ConTeXt users <ntg-context@ntg.nl>
Subject: Re: Proposal: making [[article]] and [[Article]] equivalent on the wiki
Date: Mon, 24 Sep 2012 13:11:26 +0200	[thread overview]
Message-ID: <CAF=dkzzAR-KU0vZB=u2qQxTmaVMgw3CCr-EQkh96GgaGMrV4VQ@mail.gmail.com> (raw)
In-Reply-To: <CALBOmsam3JceHJgpzZ2BaRiT-sjBm_bBYrn=osH9LdUzytXR+A@mail.gmail.com>

Hi Mojca,

Sorry, somehow I missed everything but your first line when I wrote my
reply. Here's a better answer.

Mojca wrote:
> Even if you change that setting, you still have no idea whether a page
> is "Font Tools" or "Font tools" or "font tools". You can make a link
> to [[font tools]] or [[headers and footers]] inside your sentence, but
> that still won't help you to get to
>     http://wiki.contextgarden.net/Font_Tools
>     http://wiki.contextgarden.net/Headers_and_Footers

It'll help you get to [[Multiline equations]], though. Multi-word
titles are still inconsistent, and I think that [[Headers and
footers]] and [[Font tools]] would be better titles: both more
predictable and more linkable. Wikipedia uses the same policy, and I
think it works well:

* titles are displayed with an initial capital, unless otherwise
specified with {{DISPLAYTITLE:...}}
* the rest of the title is in lowercase, except for proper nouns etc.
(e.g. TeX); just like you'd write the phrase in a sentence.
* links can be both with and without an initial capital, depending on
need at the linking end.

What we have to deal with that Wikipedia doesn't, is filenames (and a
few commands): -- we'd like those to display and behave as lowercase.
So we want lowercase on occasion, but we don't want it to get
confusing, either --- we don't want people to wonder whether to write
[[Article]] or [[article]], and we especially don't want there to be a
wrong answer. Now, neither of these requirements compel us to enable
or disable wgCapitalLinks.

File and command names can be solved like so:
1.a keep wgCapitalLinks disabled, and simply title the articles like
the filenames
1.b enable wgCapitalLinks, and simply use {{DISPLAYTITLE:filename}} on
filename articles.

No "[[Article]] vs. [[article]]" doubts can be achieved like so:
2.a keep wgCapitalLinks disabled, consistent article naming policy
plus consistently writing [[Article|article]] to get lowercased links
2.b keep wgCapitalLinks disabled, consistent article naming policy
plus a lowercase-to-titlecase (or v.v.) redirect for every article
2.c enable wgCapitalLinks. (Still need an article naming policy for
multi-word titles, of course.)

So, which is the bigger burden: lowercasing filenames manually, or
manually adjusting mid-sentence links? I think making article titles
look like filenames is more of an edge case than linking to articles
is. You write that "the ConTeXt wiki hardly covers any substantial
amount of common words or phrases", but have a look at this page:
http://wiki.contextgarden.net/index.php?title=Special:AllPages&from=Symbols&to=write18
There are only about 20 or so filename/commandname articles on the
entire wiki (excluding those under Command/), of which about 12
describe various no-longer-used zip files. There are a lot of articles
with names one could easily work into a sentence, even if we don't
have as many 'simple noun' articles as Wikipedia.

Kind regards,
Sietse
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________


      parent reply	other threads:[~2012-09-24 11:11 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-09-19 12:11 Sietse Brouwer
2012-09-19 12:13 ` Philipp Gesang
2012-09-24  8:24 ` Mojca Miklavec
2012-09-24  8:44   ` Sietse Brouwer
2012-09-24  9:32   ` Arthur Reutenauer
2012-09-24  9:44     ` Sietse Brouwer
2012-09-24 11:11   ` Sietse Brouwer [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CAF=dkzzAR-KU0vZB=u2qQxTmaVMgw3CCr-EQkh96GgaGMrV4VQ@mail.gmail.com' \
    --to=sbbrouwer@gmail.com \
    --cc=ntg-context@ntg.nl \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).