New filter for moodle.org needed to autolink to Moodle docs

New filter for moodle.org needed to autolink to Moodle docs

Martin Dougiamas發表於
Number of replies: 5
Core developers的相片 Documentation writers的相片 Moodle HQ的相片 Particularly helpful Moodlers的相片 Plugin developers的相片 Testers的相片
It would be great to be able to type Installing Moodle here on moodle.org and have it automagically look like this: Installing Moodle

Can someone with a bit of spare time look at MDLSITE-343 ?
評比平均分數: -
In reply to Martin Dougiamas

Re: New filter for moodle.org needed to autolink to Moodle docs

John Isner發表於
Recently, I wrote something in a post that contained an ordinary word. I forget the word; maybe it was "practical" -- yeah, that was it -- and I was surprised to see that it had been auto-linked to an entry in the modules and plugins database. Of course the link was completely superfluous. This got me thinking about auto-linking: How often does auto-linking create a link that is actually useful when the author didn't consciously intend it to be? Let's call this "serendipitous auto-linking." I think the answer is: not very often. So I like the idea of using special delimiters or prefixes to signal the author's intention that a link should be created. TeX and Algebra filters do this with $$$ and @@@, bug reports start with special prefixes like MDL- and MDLSITE-, and (if I understand MDLSITE-343 correctly), Martin is proposing square brackets as a way of signaling a link to articles in the documentation wiki.
In reply to John Isner

Re: New filter for moodle.org needed to autolink to Moodle docs

Séverin TERRIER發表於
Documentation writers的相片 Particularly helpful Moodlers的相片 Testers的相片 Translators的相片
I think it's a really good idea. I very often put links to the (french) documentation.

I would be very happy to be able to make simpler links to the documentation, but how could we handle localised links, like we do in the docs : [[fr:Installation de Moodle]] or [[fr:Installation de Moodle|Installer Moodle]] would be a good idea ?

I don't think multilang links would be very usefull, as nearly nobody will use them manually (and there is link IN the documentation), and apart from capability names, "real page" names are different with several languages.

Séverin
評比平均分數:Useful (1)
In reply to Séverin TERRIER

Re: New filter for moodle.org needed to autolink to Moodle docs

Matt Gibson發表於
There's already a setting for which moodle docs site to use, so I suppose it could automatically look there, without the need to specify fr again. Might cause a problem if you unzip a backed up course to a different site in another language though.
In reply to Matt Gibson

Re: New filter for moodle.org needed to autolink to Moodle docs

Séverin TERRIER發表於
Documentation writers的相片 Particularly helpful Moodlers的相片 Testers的相片 Translators的相片
I think (if i've all well understood) you're wrong : the documentation setting you can choose allow you to specify a new place for an entire Moodle documentation site, multilingual.

The fr/ (or equivalent based on user lang) are automatically added when documentation link is made.
In reply to Séverin TERRIER

Re: New filter for moodle.org needed to autolink to Moodle docs

Valery Fremaux發表於

This filter exists already in a very close version : Wikipedia Easy Links.

Just changing the URL of destination MediaWiki would do the trick I think.

Maybe could I renew the filter and make the target base URL parametrizable.

It accepts internationalisation in that way : [WP|Target topic|fr]

Could be patched to [MDL|Target topic|lang] using shortcuts : [MDL] or [MDL|fr]

Tell me about opportunity of double bracketting the call code WP,MDL in place of single bracketting.

I can work a set of hours on it. (very small amount of job needed)

(http://www.ethnoinformatique.fr/course/view.php?id=98)

Cheers.

評比平均分數:Useful (1)