search

pillar-markup / pillar

Markup syntax and associated tools to write and generate documentation, books and slides
MIT License
50 stars 37 forks source link

Semantics of links for HTML #296

Open Ducasse opened 6 years ago

Ducasse commented 6 years ago 
See *2018-Conference/conf2018.pillar*  
See  *@2018-Conference/conf2018.pillar*

render nothing. Generate

See <a href="2018-Conference/conf2018.html"></a>  
See  <a href="#2018-Conference/conf2018.pillar"></a> 
See *Foo>2018-Conference/conf2018.pillar*

rendered 

See <a href="2018-Conference/conf2018.html">Foo</a> 
*Registration>2018-Conference/conf2018.pillar@registration*

rendered

<a href="2018-Conference/conf2018.html#registration">-1 Registration</a>
See figure *@fig:Figu3*

renders

See figure 3.2
Ducasse commented 6 years ago

*@2018-Conference/conf2018.pillar* is bogus because we should not have a path on the right of an anchor.

Ducasse commented 6 years ago

by default See *2018-Conference/conf2018.pillar* should use as alias the path instead of nothing.

Ducasse commented 6 years ago

*Registration>2018-Conference/conf2018.pillar@registration* looks like a bug. It should not put -1.