dag/cll — pull request #21 by ento (2012-12-29 10:14:05+00:00)
Title: Add all todos to the issue tracker

Purpose:
* Get an overview of what needs to be done
* Easily see how far we've come
* Make it easier to help

Steps

one. [done] Add everything from the TODO file, clarifying along the way where possible. Template:

```
[Original line in the TODO file]()

pdf: n/a | ok | needs fix | unconfirmed
html-nochunks: n/a | ok | needs fix | unconfirmed
html-chapters: n/a | ok | needs fix | unconfirmed
html-sections: n/a | ok | needs fix | unconfirmed
epub: n/a | ok | needs fix | unconfirmed
mobi: n/a | ok | needs fix | unconfirmed
```

two. [done, within the scope of this task] Triage issues

----------

Todos in the TODO file as of 0d127150db8e4ba0dc059f8bf350a3dd30bc8f4e

----------

==================
Uncategorized Issues By Chapter
==================

#22 C2. S11: "gismu:" as a line by itself looks pretty lame.
#23 C2. Example 2.9 could do with some re-formatting (compare 5.3 in http://dag.github.com/cll/2/5/ )
#24 C4. Example 4.4 is formatted differently from other nearby and similar examples
#26 C4. Examples 4.24, 4.26-4.38, 4.52-4.70 are missing content
- The content in question gets deleted by xml/docbook2html_preprocess.xsl
#26 #27 C4. Examples 4.46-4.51 are broken, and 4.51 is not present in the red book
#28 C4. Broken HTML character codes on the last line of page 79 of the red book
- This is from the

tag not being handled properly in the docbook->html conversion
#29 C5. Table of language acronyms in section 14 could use reformatting to save space
#30 C7. Section cmavo lists are missing series information
- This seems to be due to the tag not being handled by the xml->docbook conversion
#31 C7. Example 7.39 is hella ugly. Like, seriously
#32 C7. Example 7.62, line 3, differs from the red book
#33 C8. Example 8.45, line 3, is missing quotes around a word
#34 C8. Extraneous spaces in the () parts after Example 8.49
#35 C9. Example 9.40 has the last two lines on one line
#36 C9. BAI tables at end of chapter are poorly formatted compared to the red book
#37 C10. pg. 223 of red book: duplicate notes on section content due to the new form for x-refs
#38 C10. Example 10.84 does not fit in with the rest of the examples
#39 C10. Example 10.147's fourth line should be at the end of the third
#40 C11. pg. 259 of the red book, definitions list is super ugly
#41 C12. pg. 288, extra space after a (
#42 C13. pg. 385, attitudinal scale cmavo table is missing a *lot*
#43 C13. Various examples have the last two lines on one line
#44 C13. Section 7: table has values flowing into extra columns instead of rows
#45 C13. Vocatives table puts the large paragraphs explaining the vocatives onto the existing table rows
#46 C14. Logical group letters are merely capitals; they need to stand out much better
#47 C14. Example 14.106 is missing a row
#48 C15. Diagram on pg. 375 could use some work
#49 C16. After Example 16.93: plurals with spaces between the valsi and the "s"
#50 C17. Letters table is ridiculously tall
#51 C18. Examples are missing numeric rows
#52 C18. Section 6 cmavo list: mo'o is in the wrong row
#53 C18. Section 8 cmavo list is missing every PA+PA row
#54 C18. Section 22, the Examples have a leading 'li' that the red book does not have
#55 C18. Section 23's selma'o table has xrefs that are not showing up
#56 C18. Section 24 is ridiculously tall
#57 C19. Examples 4.2 and 4.6 have their rows out of order
#58 C19. Example 19.33 is missing a row
#59 C19. Examples 19.52-19.54, 19.67, 19.71-19.74, 19.77, 19.81 are missing quotes
#60 C19. Examples 19.61, 19.62 are missing emphasis
#61 C20. All the examples are using different markup
#62 C20. xrefs here can be a little verbose

------

==================
I Don't Even
==================

#63

24-22:44 < rlpowell> *Neat*.
24-22:45 < rlpowell> The HTML and the LaTeX number the examples differently.
24-22:45 < rlpowell> *THAT'S* gonna need to change.
[change that *AFTER* handling all the proofread stuff, or it's going to suck)

==================
Non-Visual Issues
==================

#64
Maybe add an interlinear-gloss-manual? for manual grouping that
isn't chapter 2 style; otherwise it's hard to see how to make
something like this work:

le se nelci cu cafne
The liked-thing is-frequent.

------

#65
The tags within tables have their component in another column of the table. We need to decide whether is this is
satisfactory, or if something else should be done with them.

------

#66
tables are shit

------

#67
All the imported/manual indexterm entries for single words or
selma'o need to be checked; they should be covered adequately by
nearby or entries, both of which create index
entries. If you don't know how to search for only the relevant
entries in your particular text editor, come on #jbopre and ask.

------

#68
Clean up the "FIXME: TAG SPOT" bits. Those were put there as part
of the semi-automated index insertion project. If there's an
next to them, great; kill it. If there isn't, maybe
look around nearby and make sure that obvious tags and
similar are in use.

------

#69
Similarily, entries like
(NOTE the type) probably need to be destroyed; there should be a bit
of Lojban near them that can be wrapped in , to exactly the
same effect as the entry. If you can't find such a
correspondance, add a FIXME comment.

------

#70
Hunt down all FIXME:s and with todo type comments.
That's all going to be advanced shit, though.

==================
Visual Issues
==================

After we're done with all that, we need to actually make it look
nice. That's going to be quite a bit of work, and mostly on the
XSLT end of things, but here are some things you can do to maybe
help (you're certainly free to hack the XSLT if you know how,
though).

#71
Make sure the bits look right in the output (which
is why the columns are so spaced out).

==================
Data
==================
- #72 It seems that there is a problem with the cmavo lists at the
beginning of sections having missing entries; in particular, ones
wwith +/* in the selma'o, maybe?; they need to be manually checked
- #73 lojban words, lojban phrases, terms of art ("abstraction"),
others?... should each have their own index
- #74 list the members of each selma'o in chapter 20
- #17 `∞` is *not* IPA
- #75 In the mediaobjects in chapter 1, can we do better than The
picture for chapter 20 in terms of non-numerical cross
referencing?
- #76 there's a bunch of problems in 18.xml ; a lot of math stuff has
gotten truncated in the final form. they basically all need to be
checked; having a CLL to hand would help
- #70 Fix all FIXMEs; in particular the output of:
grep 'FIXME:' [0-9]*.xml | grep -v 'TAG SPOT'

#77
18-17:44 < tsani> rlpowell: I think that having the glossary split into [cmavo], [brivla], and
[cmene] sections might be worth while
18-17:44 < tsani> rlpowell: where the cmavo definitions say in which section the cmavo is
discussed

==================
Display
==================
- #78 links to examples should *say* "example N"; easy to test from the
index
- #79 links to sections should say the number of section and chapter
- #63 examples should be 5.2.1 rather than 5.6 for the first example in
section 2 of chapter 5
- #80 print: Add a header or footer to the left or the right page that
has the number of the chapter you're in.

- #81 for chapter 13, needs code changes to handle things like this:

```xml

fu'i
[frili]
with help
easily
without help
with opposition
with difficulty

```

the way the red book does

==================
Both/Other
==================
- #82 make sure backwards-compatible anchors exist
- Ideally, make sure they are autogenerated as part of the HTML
production.
- #83 Similarily, generate more-readable anchors based on current
section number and such

==================
Content Issues That Need Fixing
==================

DON'T TOUCH THESE. The timing on these should be handled very carefully

```
#84
2. Description of formatting for interlinear-gloss needs to be fixed to match the formatting changes
#85
2. section 2.4 should be dropped eventually.
```