George V. Koyryachy
Email: <frbrgeorge AT ЖУЧКА gmail DOT ТОЧКА com>
ALT Linux chief consulter (much more recent page in russian)
System administration consulter at CMC department (sorry, russian only page) of Moscow State University
Some MoinMoin extensions I develop, both in beta stage (lots of unresolved TODOs, but existing code works):
dot.py — «traditional dot.py» GraphViz parser replacement
- citation.py — plaintext parser which assigns an anchor to any line, so one can link to certain line in the text exactly
Some info in russian
Our «UNEEX» seminar project
Our Docmentation an Educational Heap project at ALT Linux
(See both projects are based on MoinMoin? That's it! )
Messages to me
Hi George and welcome!
Had a quick look at your citation.py and I think this is a generally useful feature that should be in moin.
Some questions about it:
why do you use name and href attribute for the <a> tag?
- what's the usage of that @ stuff (you replace it with the digit count)?
I am currently rewriting that stuff for 1.6 and formatter usage.
BTW, I guess your site is maybe the only moin site in the .su domain.
Thanks for publishing the code,
-- ThomasWaldmann 2007-02-27 09:07:17
Hi Thomas!
Thank you for your attention and comments.
We need every line of a text to be linked, so we need anchor's. Self-href makes it possible for user to get such a link directly by «copying link location», without bothering to guess how line-per-line links are named. It is usability, isn't it?
The code published at git.altlinux.ru that day was broken, indeed. Seemed to be some ill keyboard playing before commit . Now it's updated, so one can guess what the @ stuff for: it represents constant line number field width. Text with less than 100 lines will get only two characters for line number, text with less than 1000 lines will get trhee and so on.
How about my TODOs: interpunctuation context self-descriptive anchors (a.k.a. 02_All_my_troubles_seem_so_far_away), line-number show and hide (like in code blocks) and omitting direct HTML tags in parser (for future non-html formatter)?
Ah, ok, now it is clearer. I played some more with the code (in 1.6) and finally did it similar like the code parsers - now I have the normal text parser optionally with line numbering and wrapping div support. The line numbers can be switched on/off by javascript. Problem: no anchors. text.py
-- ThomasWaldmann 2007-04-01 22:08:42
But that's another story, isn't it? My aim is to provide citation destination in text/* area and the text is far from that while it has no anchors. To complete the task, one need to hack formatter.code_line so it can include an anchor in every line number code.
BTW, it may be useful to have such a link in large code containers too. The only difference: code is much more variable thing, so context links (like tagged function or class definitions) were be probably more useful. On the other side, this capability requires individual algorythm for every type of code, which seem to complificate the parser dramatically.
-- FrBrGeorge 2007-05-02 08:56:01