[lojban-announcements] Help with CLLv1.1 needed. Mostly does *NOT* require Lojban skill.
Robin Lee Powell
OK, so, I'm working on CLLv1.1. That is: CLL without any content
changes (except errata, but see below about that part), moved to a
format that we can work with easily to generate a book *or* a web
version.
This email will be pretty opaque to you unless you have experience
with XML and VCS systems (particularily git). If you have a burning
desire to help anyways (particularily with the manual labour parts),
please come on IRC and ask for help. Mention rlpowell by name.
The help I need right now is two fold:
1. Look at the source, in particular Chapter 5 sections 1 and 2,
which are completely marked up by hand by me, and tell me if you can
think of anything else that should be done *at the data structure
level*. (You can see the HTML output at
http://teddyb.org/~rlpowell/public_media/docbook-cll-test/selbri.html
; any comments on visual appearence will make me very cranky, we're
not there yet.) Like, maybe you want another index, or another
glossary, or more structure to the examples, or ..... Basically, if
you can think of any case where in the future we might go "Crap, I
wish we'd done special markup for the frobnitzes", now is the time
to think of it.
2. Loooooots of manual labour; see the "TODO" file for help needed.
It's all, unfortunately, very brain dead, but it really needs to get
done. Please help!
How to do it:
Checkout dag-cll (it's a git repo, at g...@github.com:dag/cll.git ;
github page is https://github.com/dag/cll ) and read the TODO and/or
look at the source.
To submit your changes, feel free to send me a patch personally, or
do the github fork/pull request thing; see
http://help.github.com/pull-requests/
A small word of warning:
IF YOU MAKE CONTENT CHANGES, I WILL EAT YOUR CHILDREN.
Seriously. I will come to your house and nom-nom-nom. I'm not
even joking. If you don't have kids, I'll find something else
important and eat that. Like your arms.
OK, I *am* joking, but I will be very upset, and you will be banned
from helping with this project, and probably BPFK stuff in general,
like, forever. Or until I forget.
If you see a content problem, either post to the BPFK list or update
http://www.lojban.org/tiki/tiki-index.php?page=CLL%2C+aka+Reference+Grammar%2C+Errata
-Robin
--
http://singinst.org/ : Our last, best hope for a fantastic future.
Lojban (http://www.lojban.org/): The language in which "this parrot
is dead" is "ti poi spitaki cu morsi", but "this sentence is false"
is "na nei". My personal page: http://www.digitalkingdom.org/rlp/
--
The mail came from the "Lojban Announcements" Google Group. You are probably not subscribed to that group directly. All mails to this group are forwarded to all major Lojban groups. See http://www.lojban.org/tiki/Lojbanic+Forums for details about what this list is for, including how to contact the management.
Alan Post
On Sun, Dec 19, 2010 at 06:32:10PM -0800, Robin Lee Powell wrote:
> 2. Loooooots of manual labour; see the "TODO" file for help needed.
> It's all, unfortunately, very brain dead, but it really needs to get
> done. Please help!
>
This confused me, so I'll emphasize it here:
the TODO file is in the directory todocbook, not at the top level.
-Alan
--
.i ko djuno fi le do sevzi
Robin Lee Powell
-_-
*All* of it is in the todocbook directory. Sorry about that.
Matthew Walton
> On Sun, Dec 19, 2010 at 08:25:52PM -0700, Alan Post wrote:
>> [I assume we should follow up to the mail list, so I've done
>> that.]
>>
>> On Sun, Dec 19, 2010 at 06:32:10PM -0800, Robin Lee Powell wrote:
>> > 2. Loooooots of manual labour; see the "TODO" file for help
>> > needed. It's all, unfortunately, very brain dead, but it really
>> > needs to get done. Please help!
>> >
>>
>> This confused me, so I'll emphasize it here:
>>
>> the TODO file is in the directory todocbook, not at the top level.
>
> -_-
>
> *All* of it is in the todocbook directory. Sorry about that.
This sounds like the kind of thing I can do over Christmas when I'm
away from my main computer and don't have much brainpower available. A
bit of manual XML monkeying is just the thing really. I'll clone the
repo onto my laptop and see whether this pre-7am impression is correct
or not.
mi'e mathw
Matthew Walton
look right". What's 'right'? What I think I'm seeing is an
inconsistency in when something's marked up as <en>..</en> or
<gloss>..</gloss>, but I'm not sure what it's supposed to be or indeed
if that's even what you mean us to do here.
Robin Lee Powell
> Question: the TODO file says "Make sure the interlinear-gloss bits
> look right". What's 'right'?
Look at section 5.1 and 5.2.
> What I think I'm seeing is an inconsistency in when something's
> marked up as <en>..</en> or <gloss>..</gloss>, but I'm not sure
> what it's supposed to be or indeed if that's even what you mean us
> to do here.
jbo should wrap Lojban bits that should be glossed per-word.
gloss should wrap the English per-word gloss.
en should wrap the plain/colloquial English.
If you don't have at least two parts of those, change
<interlinear-gloss> to <para>, because it isn't one.
Matthew Walton
> On Tue, Dec 28, 2010 at 02:34:13PM +0000, Matthew Walton wrote:
>> Question: the TODO file says "Make sure the interlinear-gloss bits
>> look right". What's 'right'?
>
> Look at section 5.1 and 5.2.
>
>> What I think I'm seeing is an inconsistency in when something's
>> marked up as <en>..</en> or <gloss>..</gloss>, but I'm not sure
>> what it's supposed to be or indeed if that's even what you mean us
>> to do here.
>
> jbo should wrap Lojban bits that should be glossed per-word.
> gloss should wrap the English per-word gloss.
> en should wrap the plain/colloquial English.
>
> If you don't have at least two parts of those, change
> <interlinear-gloss> to <para>, because it isn't one.
Thanks Robin. Onward to markup perfection!
Matthew Walton
Oh look I have another question about this. This is probably my fault
for choosing Chapter 3, but:
<interlinear-gloss>
<jbo>bisydja</jbo>
<gloss>BI,sy,dja</gloss>
<en>BI,syd,ja</en>
</interlinear-gloss>
That's not really a Lojban + gloss + English set, is it? It's a
progressive examination of pronunciation. Are we happy to overload
like this, should it be changed to something else, or should I just
ignore it for now? (or a fourth option I haven't thought of, of
course).
Robin Lee Powell
> On 28 December 2010 15:19, Matthew Walton
> <matthew...@gmail.com> wrote:
> > On 28 December 2010 14:56, Robin Lee Powell
> > <rlpo...@digitalkingdom.org> wrote:
> >> On Tue, Dec 28, 2010 at 02:34:13PM +0000, Matthew Walton wrote:
> >>> Question: the TODO file says "Make sure the interlinear-gloss
> >>> bits look right". What's 'right'?
> >>
> >> Look at section 5.1 and 5.2.
> >>
> >>> What I think I'm seeing is an inconsistency in when
> >>> something's marked up as <en>..</en> or <gloss>..</gloss>, but
> >>> I'm not sure what it's supposed to be or indeed if that's even
> >>> what you mean us to do here.
> >>
> >> jbo should wrap Lojban bits that should be glossed per-word.
> >> gloss should wrap the English per-word gloss. en should wrap
> >> the plain/colloquial English.
> >>
> >> If you don't have at least two parts of those, change
> >> <interlinear-gloss> to <para>, because it isn't one.
> >
> > Thanks Robin. Onward to markup perfection!
>
> Oh look I have another question about this. This is probably my
> fault for choosing Chapter 3, but:
Chapter 3 is already being worked on; probably better to pick one
somewhere in the middle.
> <interlinear-gloss>
> <jbo>bisydja</jbo>
> <gloss>BI,sy,dja</gloss>
> <en>BI,syd,ja</en>
> </interlinear-gloss>
>
> That's not really a Lojban + gloss + English set, is it? It's a
> progressive examination of pronunciation. Are we happy to overload
> like this, should it be changed to something else, or should I
> just ignore it for now? (or a fourth option I haven't thought of,
> of course).
It should be changed, either to simplelist or itemizedlist, but see
above.
Matthew Walton
> Chapter 3 is already being worked on; probably better to pick one
> somewhere in the middle.
Is there a register of what's being worked on so I can pick one that's
not already in progress?
Robin Lee Powell
No. The person working on Chapter 3 (zort- on IRC) happens to have
mentioned it to me. As far as I know, y'all are the only ones
working on it.
Robin Lee Powell
> On Tue, Dec 28, 2010 at 03:39:17PM +0000, Matthew Walton wrote:
> > On 28 December 2010 15:32, Robin Lee Powell
> > <rlpo...@digitalkingdom.org> wrote:
> > > Chapter 3 is already being worked on; probably better to pick
> > > one somewhere in the middle.
> >
> > Is there a register of what's being worked on so I can pick one
> > that's not already in progress?
>
> No. The person working on Chapter 3 (zort- on IRC) happens to
> have mentioned it to me. As far as I know, y'all are the only
> ones working on it.
Let's move this to the bpfk list; I'll try to make sure all the
relevant people are paying attention there.
Matthew Walton
> On Tue, Dec 28, 2010 at 07:50:17AM -0800, Robin Lee Powell wrote:
>> On Tue, Dec 28, 2010 at 03:39:17PM +0000, Matthew Walton wrote:
>> > On 28 December 2010 15:32, Robin Lee Powell
>> > <rlpo...@digitalkingdom.org> wrote:
>> > > Chapter 3 is already being worked on; probably better to pick
>> > > one somewhere in the middle.
>> >
>> > Is there a register of what's being worked on so I can pick one
>> > that's not already in progress?
>>
>> No. The person working on Chapter 3 (zort- on IRC) happens to
>> have mentioned it to me. As far as I know, y'all are the only
>> ones working on it.
>
> Let's move this to the bpfk list; I'll try to make sure all the
> relevant people are paying attention there.
Okay, unfortunately I'm not on that list and I can't find how to get on it.
Robin Lee Powell
http://groups.google.com/group/bpfk-list
And I've added it to
http://www.lojban.org/tiki/tiki-index.php?page=Lojbanic+Forums