* Will there ever be a standard wiki-link?
@ 2019-08-21 16:08 Joseph Reagle
[not found] ` <e7323376-2751-e4b4-4d74-14c966bb884a-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
0 siblings, 1 reply; 9+ messages in thread
From: Joseph Reagle @ 2019-08-21 16:08 UTC (permalink / raw)
To: pandoc-discuss
I'm noticing folks building wikis using markdown increasingly adopting the convention [[local link]]. However, gitit uses [local link](). Any chance one of these will be standardized or adopted by Pandoc?
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <e7323376-2751-e4b4-4d74-14c966bb884a-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
@ 2019-08-23 9:44 ` mb21
[not found] ` <9cbec34f-8bca-429f-8cf9-954dbeeb6a87-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2019-08-24 10:06 ` BPJ
1 sibling, 1 reply; 9+ messages in thread
From: mb21 @ 2019-08-23 9:44 UTC (permalink / raw)
To: pandoc-discuss
[-- Attachment #1.1: Type: text/plain, Size: 765 bytes --]
Interesting... can you link to some example docs for those wikis?
On Wednesday, August 21, 2019 at 6:08:54 PM UTC+2, Joseph wrote:
>
> I'm noticing folks building wikis using markdown increasingly adopting the
> convention [[local link]]. However, gitit uses [local link](). Any chance
> one of these will be standardized or adopted by Pandoc?
>
>
>
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/9cbec34f-8bca-429f-8cf9-954dbeeb6a87%40googlegroups.com.
[-- Attachment #1.2: Type: text/html, Size: 1230 bytes --]
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <9cbec34f-8bca-429f-8cf9-954dbeeb6a87-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
@ 2019-08-23 13:19 ` Joseph Reagle
[not found] ` <db2b6987-1e92-1e0a-6b29-d2b7265ab1cf-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
2019-08-29 12:32 ` Joseph Reagle
1 sibling, 1 reply; 9+ messages in thread
From: Joseph Reagle @ 2019-08-23 13:19 UTC (permalink / raw)
To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw
On 8/23/19 5:44 AM, mb21 wrote:
> Interesting... can you link to some example docs for those wikis?
I haven't been tracking it carefully, but I'm increasingly seeing references to "wiki style links" (double bracket) in wiki/notebook apps that use markdown.
Github wiki is probably the biggest driver, for example:
https://github.com/reagle/New-Media-Culture/wiki
https://github.com/reagle/New-Media-Culture/wiki/Home/_edit
I think Notational Velocity and its spawn are also influencing folks.
This is the recent example that prompted my email.
https://github.com/darryllawson/sublime-notedown
And I'd like to suggest they follow the [link]() syntax of gitit, but don't know how to suggest they do so...
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/db2b6987-1e92-1e0a-6b29-d2b7265ab1cf%40reagle.org.
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <db2b6987-1e92-1e0a-6b29-d2b7265ab1cf-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
@ 2019-08-23 17:14 ` John MacFarlane
[not found] ` <m2lfvjhkia.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
0 siblings, 1 reply; 9+ messages in thread
From: John MacFarlane @ 2019-08-23 17:14 UTC (permalink / raw)
To: Joseph Reagle, pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw
See https://github.com/jgm/pandoc/issues/2923
Joseph Reagle <joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> writes:
> On 8/23/19 5:44 AM, mb21 wrote:
>> Interesting... can you link to some example docs for those wikis?
>
> I haven't been tracking it carefully, but I'm increasingly seeing references to "wiki style links" (double bracket) in wiki/notebook apps that use markdown.
>
> Github wiki is probably the biggest driver, for example:
>
> https://github.com/reagle/New-Media-Culture/wiki
>
> https://github.com/reagle/New-Media-Culture/wiki/Home/_edit
>
> I think Notational Velocity and its spawn are also influencing folks.
>
> This is the recent example that prompted my email.
>
> https://github.com/darryllawson/sublime-notedown
>
> And I'd like to suggest they follow the [link]() syntax of gitit, but don't know how to suggest they do so...
>
>
>
> --
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/db2b6987-1e92-1e0a-6b29-d2b7265ab1cf%40reagle.org.
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/m2lfvjhkia.fsf%40johnmacfarlane.net.
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <m2lfvjhkia.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
@ 2019-08-23 18:17 ` Joseph Reagle
[not found] ` <d8b31c74-f60f-23a8-afc7-3cd2a76924c0-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
0 siblings, 1 reply; 9+ messages in thread
From: Joseph Reagle @ 2019-08-23 18:17 UTC (permalink / raw)
To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw
On 8/23/19 1:14 PM, John MacFarlane wrote:
> See https://github.com/jgm/pandoc/issues/2923
Ah. Didn't realize there was such an old issue. It would be nice to have a format extension...
I suppose that means it's too late for there to be a standard; my cursory glance at CommonMark didn't show any discussion of `[link]()` vs `[[link]]`.
In fact, in CommonMark:
[link]() ▶ <p><a href="">link</a></p> [1]
and an empty href quote, according to HTML, is an empty URI reference, pointing to the current document -- which is different than gitit.
[1]: https://spec.commonmark.org/0.28/#example-461
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d8b31c74-f60f-23a8-afc7-3cd2a76924c0%40reagle.org.
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <d8b31c74-f60f-23a8-afc7-3cd2a76924c0-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
@ 2019-08-23 19:17 ` John MacFarlane
[not found] ` <yh480kmufzbsju.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
0 siblings, 1 reply; 9+ messages in thread
From: John MacFarlane @ 2019-08-23 19:17 UTC (permalink / raw)
To: Joseph Reagle, pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw
Joseph Reagle <joseph.2011-T1oY19WcHSwdnm+yROfE0A@public.gmane.org> writes:
> In fact, in CommonMark:
>
> [link]() ▶ <p><a href="">link</a></p> [1]
>
> and an empty href quote, according to HTML, is an empty URI reference, pointing to the current document -- which is different than gitit.
It's the same in pandoc. Gitit simply treats links with empty
URLs as wikilinks -- it's a convention that requires no
new syntax.
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/yh480kmufzbsju.fsf%40johnmacfarlane.net.
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <yh480kmufzbsju.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
@ 2019-08-23 22:02 ` Kolen Cheung
0 siblings, 0 replies; 9+ messages in thread
From: Kolen Cheung @ 2019-08-23 22:02 UTC (permalink / raw)
To: pandoc-discuss
[-- Attachment #1: Type: text/plain, Size: 113 bytes --]
I think both [this syntax] and [this one][] is valid. The later might require adding a multimatkdown extension.
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <e7323376-2751-e4b4-4d74-14c966bb884a-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
2019-08-23 9:44 ` mb21
@ 2019-08-24 10:06 ` BPJ
1 sibling, 0 replies; 9+ messages in thread
From: BPJ @ 2019-08-24 10:06 UTC (permalink / raw)
To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw
[-- Attachment #1: Type: text/plain, Size: 1235 bytes --]
On 2019-08-21 18:08, Joseph Reagle wrote:
> I'm noticing folks building wikis using markdown increasingly adopting the convention [[local link]]. However, gitit uses [local link](). Any chance one of these will be standardized or adopted by Pandoc?
>
The attached Lua filter kind of does the trick if you want to generate
Markdown e.g. for GitHub wikis. It converts three different "syntaxes"
into wiki link syntax:
Get [[...]] style wiki links in Pandoc Markdown output:
[PAGE NAME]() becomes [[PAGE NAME]] (Formatting is lost)
[FORMATTED TEXT]{wiki="PAGE NAME"}
becomes [[PAGE NAME|FORMATTED TEXT]]
`TEXT`{.wiki} becomes [[TEXT]] (Very fast!)
$ pandoc --lua-filter wiki-links.lua -w gfm
[foo]() [*bar*]{wiki="baz"} `quux`{.wiki}
^D
[[foo]] [[baz|*bar*]] [[quux]]
--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/93baab2f-5229-5985-2332-aa503eee0b95%40gmail.com.
[-- Attachment #2: wiki-links.lua --]
[-- Type: text/x-lua, Size: 2947 bytes --]
--[=====================================================================[
Get [[...]] style wiki links in Pandoc Markdown output:
[PAGE NAME]() becomes [[PAGE NAME]] (Formatting is lost)
[FORMATTED TEXT]{wiki="PAGE NAME"} becomes [[PAGE NAME|FORMATTED TEXT]]
`TEXT`{.wiki} becomes [[TEXT]] (Very fast!)
$ pandoc --lua-filter wiki-links.lua -w gfm
[foo]() [*bar*]{wiki="baz"} `quux`{.wiki}
^D
[[foo]] [[baz|*bar*]] [[quux]]
--]=====================================================================]
local wiki_class = "wiki" -- feel free to change this to e.g. "w"
function Link (elem)
if "" == elem.target then
local text = pandoc.utils.stringify(elem)
return {
pandoc.RawInline('markdown', '[[' .. text .. ']]' )
}
end
return nil
end
function Code (elem)
if elem.classes:includes(wiki_class) then
return { pandoc.RawInline('markdown', '[[' .. elem.text .. ']]') }
end
return nil
end
function Span (elem)
local wiki = elem.attributes[wiki_class]
if wiki then
-- construct the part before the formatted text
prefix = pandoc.RawInline('markdown', '[[' .. wiki .. '|')
-- the part after the formatted text
suffix = pandoc.RawInline('markdown', ']]')
-- the formatted text == the span content
local content = elem.content
-- prepend the prefix
table.insert(content, 1, prefix)
-- append the suffix most efficiently
content[#content+1] = suffix
return content
end
return nil
end
--[=====================================================================[
This software is Copyright (c) 2019 by Benct Philip Jonsson.
This is free software, licensed under:
The MIT (X11) License
The MIT License
Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software
without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to
whom the Software is furnished to do so, subject to the
following conditions:
The above copyright notice and this permission notice shall
be included in all copies or substantial portions of the
Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT
SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
--]=====================================================================]
-- Vim: set ft=lua sw=2 sts=2 et fdm=indent:
^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Will there ever be a standard wiki-link?
[not found] ` <9cbec34f-8bca-429f-8cf9-954dbeeb6a87-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2019-08-23 13:19 ` Joseph Reagle
@ 2019-08-29 12:32 ` Joseph Reagle
1 sibling, 0 replies; 9+ messages in thread
From: Joseph Reagle @ 2019-08-29 12:32 UTC (permalink / raw)
To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw
On 8/23/19 5:44 AM, mb21 wrote:
> Interesting... can you link to some example docs for those wikis?
This ST extension, as well, uses double bracket.
https://packagecontrol.io/packages/MarkdownEditing#wiki-features
^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2019-08-29 12:32 UTC | newest]
Thread overview: 9+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-08-21 16:08 Will there ever be a standard wiki-link? Joseph Reagle
[not found] ` <e7323376-2751-e4b4-4d74-14c966bb884a-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
2019-08-23 9:44 ` mb21
[not found] ` <9cbec34f-8bca-429f-8cf9-954dbeeb6a87-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2019-08-23 13:19 ` Joseph Reagle
[not found] ` <db2b6987-1e92-1e0a-6b29-d2b7265ab1cf-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
2019-08-23 17:14 ` John MacFarlane
[not found] ` <m2lfvjhkia.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
2019-08-23 18:17 ` Joseph Reagle
[not found] ` <d8b31c74-f60f-23a8-afc7-3cd2a76924c0-T1oY19WcHSwdnm+yROfE0A@public.gmane.org>
2019-08-23 19:17 ` John MacFarlane
[not found] ` <yh480kmufzbsju.fsf-pgq/RBwaQ+zq8tPRBa0AtqxOck334EZe@public.gmane.org>
2019-08-23 22:02 ` Kolen Cheung
2019-08-29 12:32 ` Joseph Reagle
2019-08-24 10:06 ` BPJ
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).