documentation

classic Classic list List threaded Threaded
Assigned to fschmidt at priority
 2 
(High)
10 messages Options
Reply | Threaded
Open this post in threaded view
|

documentation

fschmidt
Administrator
I will work on documentation.
Woe to those who call bad good and good bad -- Isaiah 5:20
Following the Old Testament, not evil modern culture
Reply | Threaded
Open this post in threaded view
|

Re: documentation

fschmidt
Administrator
Hugo, please get the Luan source and look at docs/manual.html .  If I add
<div></div>
on line 178 at the end of the "Introduction" section then the heading of the next section gets messed up.  Why?

Feel free to edit the css files which I took from lua.org .  You may also conbined them into one file.

My plan is to edit this document and to use classes like class="added", class="removed", class="changed" to indicate how Luan differs from Lua.
Woe to those who call bad good and good bad -- Isaiah 5:20
Following the Old Testament, not evil modern culture
Reply | Threaded
Open this post in threaded view
|

Re: documentation

Hugo <Nabble>
manual.css has a rule like this:
p+h1, ul+h1 {
   ...
}
This rule means "for headers (h1) tags that come after a paragraph (p) or after an unordered list (ul), do...".
When you add a div between the paragraph and the header, you break that rule. A simple solution is to change the rule like this:
p+h1, ul+h1, h1.myheader {
   ...
}
and then change the h1 headers in the HTML file to:
...
<h1 class="myheader">
...
Reply | Threaded
Open this post in threaded view
|

Re: documentation

fschmidt
Administrator
This "p+h1, ul+h1" is horrible.  So I could replace it with "h1.myheader" and add that class to all headers.  But the only h1 where this doesn't apply is the top one, so maybe I could just make the rule "h1" and somehow treat the top case differently.  Which way is better?
Woe to those who call bad good and good bad -- Isaiah 5:20
Following the Old Testament, not evil modern culture
Reply | Threaded
Open this post in threaded view
|

Re: documentation

Hugo <Nabble>
fschmidt wrote
I could just make the rule "h1" and somehow treat the top case differently.
This is the simplest.
Reply | Threaded
Open this post in threaded view
|

Re: documentation

fschmidt
Administrator
Hugo <Nabble> wrote
fschmidt wrote
I could just make the rule "h1" and somehow treat the top case differently.
This is the simplest.
Okay but I don't know how to do this.  Can you do it?
Woe to those who call bad good and good bad -- Isaiah 5:20
Following the Old Testament, not evil modern culture
Reply | Threaded
Open this post in threaded view
|

Re: documentation

Hugo <Nabble>
I can't commit to the luan trunk.
Reply | Threaded
Open this post in threaded view
|

Re: documentation

fschmidt
Administrator
fixed
Woe to those who call bad good and good bad -- Isaiah 5:20
Following the Old Testament, not evil modern culture
Reply | Threaded
Open this post in threaded view
|

Re: documentation

Hugo <Nabble>
Done in rev 243.
Reply | Threaded
Open this post in threaded view
|

Re: documentation

fschmidt
Administrator
In reply to this post by fschmidt
lowering to priority 2 until some other things are done
Woe to those who call bad good and good bad -- Isaiah 5:20
Following the Old Testament, not evil modern culture