Edgewall Software
Modify

Opened 10 years ago

Last modified 2 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@…
Release Notes:
API Changes:

Description (last modified by cboos)

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 Changed 10 years ago by daniel

  • Milestone set to 0.9

comment:2 Changed 10 years ago by daniel

  • Priority changed from normal to lowest

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.

comment:3 follow-up: Changed 10 years ago by 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. Except having trac as code-processor but this is not that much work.

comment:4 Changed 10 years ago by cmlenz

  • Description modified (diff)
  • Milestone 0.9 deleted
  • Priority changed from lowest to low
  • Severity changed from normal to enhancement

comment:5 Changed 9 years ago by anonymous

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.

comment:6 follow-up: Changed 9 years ago by anonymous

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!

comment:7 Changed 8 years ago by anonymous

+1

comment:8 follow-up: Changed 8 years ago by slamb@…

  • Cc slamb@… 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 in reply to: ↑ 3 Changed 8 years ago by cboos

  • Description modified (diff)
  • Milestone set to 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 in reply to: ↑ 6 Changed 8 years ago by cboos

Replying to anonymous:

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!

Well, Trac without the TracLinks

comment:11 in reply to: ↑ 8 Changed 8 years ago by cboos

  • 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 Changed 5 years ago by anonymous

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:13 Changed 5 years ago by cboos

  • Milestone changed from 2.0 to unscheduled

Milestone 2.0 deleted

comment:14 Changed 4 years ago by cboos

  • Milestone changed from triaging to unscheduled
  • Owner jonas deleted

comment:15 Changed 2 years ago by Ethan Jucovy <ethan.jucovy@…>

  • Cc ethan.jucovy@… 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.

Modify Ticket

Change Properties
Set your email in Preferences
Action
as new The ticket will remain with no owner.
as The resolution will be set. Next status will be 'closed'.
The owner will be changed from (none) to anonymous. Next status will be 'assigned'.

Add Comment


E-mail address and name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.