Opened 20 years ago
Last modified 9 years ago
#615 new enhancement
Change default wiki syntax
Reported by: | toni | Owned by: | |
---|---|---|---|
Priority: | low | Milestone: | unscheduled |
Component: | wiki system | Version: | 0.7.1 |
Severity: | normal | Keywords: | wikisyntax |
Cc: | slamb@…, ethan.jucovy@… | Branch: | |
Release Notes: | |||
API Changes: | |||
Internal Changes: |
Description (last modified by )
The wiki supports several different formats like restructured text and html.
It would be nice if it would be possible to change the default syntax that is
used in the wiki. So that you could for example use restructured text without the {{{ }}}
blocks.
Attachments (0)
Change History (15)
comment:1 by , 20 years ago
Milestone: | → 0.9 |
---|
comment:2 by , 20 years ago
Priority: | normal → lowest |
---|
follow-up: 9 comment:3 by , 20 years ago
comment:4 by , 20 years ago
Description: | modified (diff) |
---|---|
Milestone: | 0.9 |
Priority: | lowest → low |
Severity: | normal → enhancement |
comment:5 by , 19 years ago
I think the syntax defined by Markdown is far superior to most wikis, including what Trac supports. Personally, I'm sick of trying to remember how many a zillion different wiki syntaxes, and Markdown is the only one I've seen that's actually readable by human beings, even when displayed as plain-text. I'm really reluctant to force yet another wiki on my users that doesn't use something semi-standard. Using Markdown via Instiki is by far the best user experience I've found.
follow-up: 10 comment:6 by , 19 years ago
Ditto to the last comment, I'd give anything to be able to switch away from the default Trac wiki syntax to Textile or Markdown!
follow-up: 11 comment:8 by , 18 years ago
Cc: | added |
---|
I'm still new to trac, but my only real technical complaint with its default syntax is the linking. I don't think all CamelCase words should be a link unless manually excluded, and I would like to encourage using non-CamelCase page names. I prefer MediaWiki's link syntax and its usage on Wikipedia - link to only the first reference to a term, and only if it's relevant. But really, if I could just turn off autolinking to CamelCase words, I'd probably be fairly happy. trac's explicit link syntax is good enough. (Maybe I'll open a new enhancement ticket for this; it's not a much bigger change than ignore_missing_pages
.)
As far as consistency with other wikis, I'm torn between the only two I think are important:
- MediaWiki, which has a pretty good syntax, and more importantly, is the one everyone is familiar with. (Raise your hands if you've heard of Wikipedia…)
- Other trac installations. It's becoming quite popular for open source projects, and it's reasonable for people to expect the same syntax to work between trac installations X and Y. If it didn't, people would get really frustrated.
If all trac users were behind a change to MediaWiki syntax, there'd be no conflict for me. But I really doubt that could happen - I think the trac developers wouldn't have chosen this syntax if they didn't like it, and every page in existing installations adds inertia.
I looked at Markdown just now and it wasn't so obviously superior as to overrule its obscurity. It's kind of nice, but looks like it'd be much easier to edit in a fixed-width capable editor than in the usual web input block.
comment:9 by , 18 years ago
Description: | modified (diff) |
---|---|
Milestone: | → 2.0 |
Replying to tonib:
You dont have to support all wiki formats. It would be enough to support all wiki formats that have implemented TracWiki features.
With the patch in #779 and #780 restructured text supports all trac features.
I think it's worth thinking about it, but it seems however highly unlikely to me that a Trac site could run successfully if reST was the default wiki syntax…
comment:10 by , 18 years ago
comment:11 by , 18 years ago
Keywords: | wikisyntax added |
---|
Replying to slamb@slamb.org:
… If all trac users were behind a change to MediaWiki syntax, there'd be no conflict for me. But I really doubt that could happen - I think the trac developers wouldn't have chosen this syntax if they didn't like it…
Well, there's nothing terribly great about the MoinMoin style for bold and italics, for example… (oh, MediaWiki has the same syntax for that incidentally).
We're willing to get some more convergence about the wiki syntax (see WikiCreole), and we'll probably support MediaWiki tables at some point in the future (#1424).
comment:12 by , 15 years ago
Would it be possible to perhaps have a button on an edit bar to pop in a trac syntax block so you can easily insert a traclink into a wiki which is processed as MW by default? Eg.
==MediaWiki stuff== {{{ #!trac TracLinkHere }}} ===Little more MediaWiki...===
Or perhaps all on one line? "{{{ #!trac TracLinkHere
}}}"?
(btw, I know the syntax is probably wrong, not switching to Trac til I know I can use my existing MediaWiki syntax+database)
comment:14 by , 14 years ago
Milestone: | triaging → unscheduled |
---|---|
Owner: | removed |
comment:15 by , 12 years ago
Cc: | added |
---|
Relatedly, I'd like to be able to disable the wiki syntax altogether, and let my users just input wiki fields (ticket descriptions and comments, milestone descriptions, etc) directly as HTML. At the moment the only way to do that is by monkey-patching Trac's internals. This more or less works (in e.g. my wsgi.py
file) but it's not comprehensive; it doesn't catch the OneLinerFormatter
stuff used in the timeline view and search results, for example:
from trac.wiki import formatter OriginalFormatter = formatter.Formatter class NullFormatter(OriginalFormatter): def format(self, text, out=None, escape_newlines=False): if out is not None: out.write(text) return formatter.Formatter = NullFormatter
For what it's worth, the resulting breakage of wiki links (and wiki macros, and all the other neat features of the wiki system) is not so important for my needs.
Changing the default wiki-syntax would break TracLinks, unless added to all supported wiki formats (alot of work), so this is probably not a good idea.
OTOH, it might be cool to have a popupmenu when editing a wiki page to select syntax/formatter to use. That would make adding a page entirely formatted in foosyntax more convenient.