Book Week: Playing Beatie Bow

This article originally appeared on Hoyden About Town.

This is part of Tansy Rayner Roberts’s Blog Book Week challenge, about favourite childhood reading, how we read these books, and why we remember them.

I’m going to write about two Ruth Park books this week, Playing Beatie Bow and My Sister Sif.

Spoilers for Playing Beatie Bow ahoy!

Background/plot summary: Playing Beatie Bow is a 1980 older children’s book by New Zealand/Australian author Ruth Park. In it, fourteen year old Abigail sees a strange young girl (thin, wearing odd clothes, “furry” shorn head) watching her babysitting charges play, especially when they play “Beatie Bow”, a ghost game. One day she gives chase to the girl and finds herself in Sydney in the same area, only in 1873. She quickly incurs a head injury after being knocked down in the street by Samuel Bow, a war veteran who himself has a brain injury and “takes spells” (flashbacks) as a result. It emerges that the strange girl is his daughter, Beatie, who had found herself several times in the twentieth century watching a game featuring her own ghost.

Photograph of a street in The Rocks, Sydney, circa 1900
The Rocks, circa 1900, State Records NSW, CC BY

While both parties hide their knowledge from each other for a while, the Bow and Tallisker (Beatie’s mother’s name) families who share a house in the Rocks know that Abigail is from a different time and will not help her return to the twentieth century. It emerges that some of the women in their family have a psychic Gift as a result of their Orkney heritage, and that every fifth generation it is imperiled, with a prophecy that of the adults in that generation, one is to be barren and one to die, risking there not being another generation. When this happens, the family is visited across time by The Stranger, in this case Abigail, who is destined to save enough of them to continue the Gift. The family has recently had scarlet fever and only a few members of the fifth generation survive: Beatie; her older brother Jonah; and her younger brother, Gilbert, yet to recover his health after the fever; and their cousin Dorcas (“Dovey”). Abigail is initially desperate to return home, but falls in love with Jonah, a sailor, when he has shore leave, and is more conflicted, especially since Jonah is betrothed to Dovey.

Eventually Samuel Bow causes a house fire, from which Abigail saves Dovey and Gilbert. She returns to the twentieth century that same day, under the care of Beatie, still cross with Abigail for pursuing Jonah. Shortly after returning she researches the family history in the newspapers, which suggests that Jonah probably died at sea shortly after she left. She then has a vision which shows that Beatie became a scholar, and that Jonah married Dovey but indeed died young at sea. She tries and fails to warn the family across time. Abigail is overwhelmed with grief that she cannot speak of.

Before long her own parents reunite after years of separation and move with her to Norway. In the final pages of the novel, she returns to Sydney five years later to discover by chance that the Crowns, her former babysitting charges, are descendants of Gilbert Bow through their mother, and (it is heavily implied) Abigail begins a relationship with their uncle Robert Bow after the novel ends. She realises that instead of her role as The Stranger being to save Dovey from the fire for Jonah as the family had believed, it was to save Gilbert.


I think I received Playing Beatie Bow as a gift from a book-loving relative. I wasn’t born when it was written, and probably read it in about 1992 or a bit later, when I was slightly younger than Abigail is for most of the novel. I remember finding the twentieth century portions rather strange for a while: this relative was in the habit of giving me high quality very recent books, and I didn’t realise for a while that the book was more than a decade old and the portrayals of Abigail’s high school experience (secondhand, as she thinks of them with contempt over summer) were using slang and events from the late 1970s! At the time I knew almost nothing about the 1970s, so it sounded rather as if Park had made up a bunch of plausible sounding teenage slang.

Photograph of George Street, The Rocks, at night, showing mostly well-kept pubs and restaurants
The Rocks in 2009, by Richard Taylor, CC BY

Abigail’s teenage alienation was a bit of a foreign country to me at the time. The novel begins with her spending the summer being angry about all sorts of things: her father leaving her mother for another woman, which has alienated Abigail so much she has changed her given name to one that isn’t connected with her father’s affection; her peers at school and their teenage crushes; her mother’s decision to re-partner with her father after his long-lived relationship with another woman. Interestingly, a big part of the novel is Abigail, via falling in love with someone else’s fiancé, coming to a realisation that there’s more going on with love than people falling in love to spite her. The coda at the end in which Abigail has demonstrably grown up emotionally in her nine-odd months in 1873 and then her five years in Norway was also important to me: the Norway part of the arc, being realism, maybe more important than the time-travelling.

It was probably also one of the first encounters I had with a critique of the idea that history is a uniform progression from worse conditions to better conditions (yeah I know, a pretty obvious misconception in hindsight): this critique is put into the mouth of Jonah who is utterly uninterested in the magic that awaits his world in the twentieth century.

Sydney always makes novels memorable for me, too. I didn’t grow up in Sydney, but rather in regional NSW, and as a teenager it tended to signify freedom to me. I was always very excited to have a book with a strong Sydney-centric sense of place: besides Playing Beatie Bow I think only Melina Marchetta’s novels were as evocative for me. (Only Looking For Alibrandi was actually published when I was a child, I was 22 and already lived in Sydney when she published Saving Francesca, and a new mother in my late twenties when The Piper’s Son came out.) Playing Beatie Bow is very thoroughly set in The Rocks around Argyle Street, and grounded in the local geography to the point where I believe it’s possible to identify the set of stairs that led Beatie into the twentieth century and Abigail into 1873.


Fan service insight for other dedicated Beatie Bow readers: there’s very brief speculation by Robert Bow at the end of the novel that his niece Natalie Crown, Abigail’s former babysitting charge and the only other person who could see Beatie watching them play, has the Gift, but otherwise the form the Gift takes in Gilbert’s descendants and what it means to have it with very little cultural connection to the Orkneys and its supernatural origins there, is totally unexplored.

I worked this over several times when I was younger: if I was counting the generations correctly, the fifth generation of Talliskers/Bows/Crowns after Gilbert ought to be Natalie and her brother Vincent, which should make them subject to the “one to be barren, one to die” curse (by the way, the inevitable “cursedness” of being childless is called out in the novel, by Beatie who deeply wants to be, and ends up being, the childfree one). If Abigail and Robert had children, the fifth generation would contain their children also. This last is of course a stretch given that about the first week of Abigail and Robert’s relationship is shown in the novel, but hey, fanon calling.

In addition, in the novel, Granny Tallisker, who had the strongest Gift, spends some time trying and failing to work out why on earth Abigail is their Stranger, since they expected someone with a family relationship. Neither of them at that point knows about the relationship with the Crown children, or for that matter that Gilbert is to live. But if a family relationship is required, Abigail doesn’t have this it unless she goes on to partner with Robert Bow.

In any event, whatever happens to Robert and Abigail, it seems that the Crowns are due a Stranger at some point in their lives. I was always surprised that Park didn’t write a sequel, given this (although as an adult, I can see why it would be difficult to preserve the tone with one novel set in 1873 and the other in the late twentieth century). In my fanon, a somewhat older Beatie ends up being their Stranger, in a reciprocal relationship to that Abigail had with her family.

Sunday Spam: bagels, lox and smoked salmon

In belated honour of my breakfast in New York, Sunday July 8.

Baby Loss and the Pain Olympics
Warning for baby loss discussion.

I really have to question why seeing someone else processing their emotions is her pet peeve.

Do I believe a miscarriage and neonatal death is the same thing — of course not. If they were the same thing, they would share the same term. But just because I see them as apples and oranges doesn’t mean that I don’t also see them as fruit. They are both loss.

The deadly scandal in the building trade

Readers would not guess from the “national conversation” that the construction industry is sitting on a story as grave in its implications as the phone-hacking affair – graver I will argue. You are unlikely to have heard mention of it for a simple and disreputable reason: the victims are working-class men rather than celebrities… The construction companies could not be clearer that men who try to enforce minimum safety standards are their enemies. The files included formal letters notifying a company that a worker was the official safety rep on a site as evidence against him.

On Technical Entitlement

By most measures, I should have technical entitlement in spades… [and yet] I am very intimidated by the technically entitled.

You know the type. The one who was soldering when she was 6. The one who raises his hand to answer every question–and occasionally try to correct the professor. The one who scoffs at anyone who had a score below the median on that data structures exam (“idiots!”). The one who introduces himself by sharing his StackOverflow score.

Puzzling outcomes in A/B testing

A fun upcoming KDD 2012 paper out of Microsoft, “Trustworthy Online Controlled Experiments: Five Puzzling Outcomes Explained” (PDF), has a lot of great insights into A/B testing and real issues you hit with A/B testing. It’s a light and easy read, definitely worthwhile.

Selected excerpts:

We present … puzzling outcomes of controlled experiments that we analyzed deeply to understand and explain … [requiring] months to properly analyze and get to the often surprising root cause … It [was] not uncommon to see experiments that impact annual revenue by millions of dollars … Reversing a single incorrect decision based on the results of an experiment can fund a whole team of analysts.

When Bing had a bug in an experiment, which resulted in very poor results being shown to users, two key organizational metrics improved significantly: distinct queries per user went up over 10%, and revenue per user went up over 30%! …. Degrading algorithmic results shown on a search engine result page gives users an obviously worse search experience but causes users to click more on ads, whose relative relevance increases, which increases short-term revenue … [This shows] it’s critical to understand that long-term goals do not always align with short-term metrics.

Angels & Demons

One of the various Longform collections, and like many of them, a crime piece:

On June 4, 1989, the bodies of Jo, Michelle and Christe were found floating in Tampa Bay. This is the story of the murders, their aftermath, and the handful of people who kept faith amid the unthinkable.

On Leaving Academia

As almost everybody knows at this point, I have resigned my position at the University of New Mexico. Effective this July, I am working for Google, in their Cambridge (MA) offices.

Countless people, from my friends to my (former) dean have asked “Why? Why give up an excellent [some say ‘cushy’] tenured faculty position for the grind of corporate life?”

Honestly, the reasons are myriad and complex, and some of them are purely personal. But I wanted to lay out some of them that speak to larger trends at UNM, in New Mexico, in academia, and in the US in general. I haven’t made this move lightly, and I think it’s an important cautionary note to make: the factors that have made academia less appealing to me recently will also impact other professors.

Ethics, Culture, & Policy: Commercial surrogacy in India: A $2 billion industry

Since its legalization in 2002, commercial surrogacy in India has grown into a multimillion-dollar industry, drawing couples from around the world. IVF procedures in the unregulated Indian clinics generally cost a fraction of what they would in Europe or the U.S., with surrogacy as little as one-tenth the price. Mainstream press reports in English-language publications occasionally devote a line or two to the ethical implications of using poor women as surrogates, but with few exceptions, these women’s voices have not been heard.

Sociologist Amrita Pande of the University of Cape Town set out to speak directly with the “workers” to see how they are affected by such “work.”

I take it we aren’t cute enough for you?

This article originally appeared on Geek Feminism.

A few times within the lifetime of this blog, there’s been a major emergency in geekdom: a geek girl has needed a confidence boost.

I hear you cough. Someone just said “geek girl” on Geek Feminism, the home of “ahem, geek women, THANK YOU”?

No really, I mean it, a geek girl. A prepubescent girl has been bullied or heard some gender essentialist crap, and a call to arms goes out. The best known is probably Katie Goldman, the then seven year old whose mother wrote in November 2010 that Katie was being bullied for liking Star Wars, a boy thing:

But a week ago, as we were packing her lunch, Katie said, “My Star Wars water bottle is too small.  It doesn’t hold enough water.  Can I take a different one?”  She searched through the cupboard until she found a pink water bottle and said, “I’ll bring this.”

I was perplexed.  “Katie, that water bottle is no bigger than your Star Wars one.  I think it is actually smaller.”

“It’s fine, I’ll just take it,” she insisted.

I kept pushing the issue, because it didn’t make sense to me.  Suddenly, Katie burst into tears.

She wailed, “The first grade boys are teasing me at lunch because I have a Star Wars water bottle.  They say it’s only for boys.  Every day they make fun of me for drinking out of it.  I want them to stop, so I’ll just bring a pink water bottle.”

Katie’s story went viral including at the official Star Wars blog and a year later CNN reported that at GeekGirlCon when a brigade of Storm Troopers formed an honor guard for Katie, and that there’s an annual Wear Star Wars day as a result.

We had our own smaller burst of geek support on the Geek Feminism blog in May this year, for five year old Maya, who was turning away from her love of cars and robots. 170 comments were left on our blog for Maya, second only to Open Letter to Mark Shuttleworth (200 comments) in our history. In addition, it wasn’t an especially difficult thread to moderate as I recall: a few trolls showed up to tell Maya goodness knows what (sudo make me a sandwich LOL?) but in general people left warm, honest, open stories of their geek life for Maya.

Here’s something I was struck by: when I tweeted about Maya’s post, back in May, I saw replies from men saying that they were crying (with joy, I assume!) about the response to Maya. I have to say I do NOT see a lot of admitted crying about other posts on our blog, no matter how positive or inspirational. (People love the existence of the Wednesday Geek Women posts, but they are consistently our least read and commented on posts.) Or crying about stories that are negative and horrifying either.

It’s going to be hard to stand by a statement that I don’t begrudge Katie and Maya their outpouring of support, but: I don’t begrudge Katie and Maya their outpouring of support. I don’t think they should have less of it.

… but I think geek women and other bullied or oppressed geeks should have more.

Thus I do want to ask why girls? Why do we not have 170 comments on our blog reaching out to women who are frustrated with geekdom? I want to get this out in the open: people love to support geek girls, they are considerably more ambivalent about supporting geek women.

I’ve compared harassment of adults with bullying of children before: they have a lot in common. What they don’t seem to have in common is a universal condemnation from geekdom: bullying children? Totally evil*. Harassing adults? Eh… evil, except you know, he’s such a great guy, and he hasn’t got laid in a while, and (trigger warning for rapist enabling) he does have the best gaming table, so what are you gonna do, huh?

There are a number of reasons, I know, even aside from the (provocative!) title of the blog post. Some of them are more sympathetic than others:

  • Talking to adults about overcoming difficulties is harder. There can’t always be as much optimism or tales of It Gets Better. For some adults, that’s bullshit. (It’s not always true for children either and telling children this can be a disservice too, but it is more culturally comfortable.)
  • Adults are often angry when they’ve been mistreated. In this case, feminists are often angry. It’s harder to engage with angry people. They (we) are less appealing. We may not be grateful for your thoughts. Sometimes we pick them apart publicly if we don’t like them enough. And call you mean names.
  • When a child is bullied by another child, the bad guy is reassuringly definitely not you.
  • Children don’t talk back, or can’t. If an adult says that It Gets Better, the appropriate role for the child is to smile and look grateful. (This is also true of women when listening to men, but generally somewhat less so.)
  • Many of us are more familiar with the experience of being a bullied child than being a harassed or oppressed adult, and can be empathetic more easily.
  • We really really want to believe that things will be basically OK for Katie and Maya, even if they haven’t been for us and people we love.

There’s no easy answer. Many of us are very deeply invested in It Gets Better rhetoric, because the alternative is sure pretty sucky. But at the same time, if you’re doing one thing to stop gendered bullying this year, say, leaving the 170th supportive comment for a five year old girl, while kind, was probably not the single best use of your one thing. Join the fight. Make it better yourself. And, since you aren’t in fact limited to one thing, leave kind or supportive or co-signed righteously angry comments too, while you’re at it, and not only for children.

* At least, in the context of these discussions. I am far from believing that geeks are universally actively working to save children from bullying, nor that they are incapable of perpetrating child abuse.

Weekend womanscraft: winter warmers

This article originally appeared on Hoyden About Town.

Anyone who has spent Thursday night/Friday in NSW is probably in need of some winter warmers, at least! What’s warming your innards this season? Here are a few recipes of ours, household style (that is, very imprecise measurements).

Cream of mushroom soup

Closeup photo of about ten button mushrooms

Ingredients:
A few handfuls of button mushrooms.
Half an onion.
About 800mL of stock, possibly somewhat more if using a stove top.
About 100mL of cream or sour cream, or some mixture thereof.

NB: I prefer and recommend sour cream but my co-cook despises it, so we tend to make it with cream.

Preparation: Chop up the mushrooms and onions. Fry the mushrooms and onions together. Add the stock and simmer for 5 to 10 minutes. Add the cream and simmer briefly. Pour into a blender and blend until smooth.

Photo of mushrooms and onions in a frying pan

Alternative preparation: Chop up the mushrooms and onions. Place in slow cooker with cream and stock on low for 4 hours. Pour into a blender and blend until smooth.

Optional additions: we don’t cook anything much in our house in winter without thyme and bay leaves. Be sure to remove the bay leaf before blending.

Serving suggestion: grind pepper over the result.

Closeup photo of a bowl of cream of mushroom soup

Slow cooked chicken drumsticks

Ingredients:
An appropriate number of chicken drumsticks.
A 400g tin of diced tomatoes for about every 8 drumsticks.
About 100mL of stock for every drumstick.
A splash of white wine.
As many olives as you think sounds good.
Optional: onion garlic, thyme, bay leaf, etc.

Preparation: roll/dip/immerse the drumsticks in plain flour and briefly brown them in a fry pan (perhaps with onions and garlic). Place them in a slow cooker with all other ingredients and slow cook on high for 4 hours.

Serving suggestion: we serve with couscous.

Red lentil daal

For this we follow a recipe pretty closely, namely Stephanie Alexander’s recipe in The Cook’s Companion. It’s very similar to her published recipe in Fairfax’s Cuisine, except we haven’t been using chilli or mustand seeds.

I’ve also tried this in a slow cooker (don’t pre-soak the lentils, have all the pot ingredients in for 8 hours on low) but it ended up being too smooth for my tastes (I have a very strong aversion to some types of very smooth food, namely well-mashed potatoes, ripe avocados, and a few other things, and this daal went into that range).

Closeup photo of a bowl full of daal, with fried onions on top and brown rice behind.

Apple crumble

Closeup photograph of cutup apple being placed in cooking vessels.

Another dish where we follow a (simple!) recipe closely, specifically Donna Hay’s recipe for individual portions. We had great luck also, when we had some passionfruit to spare, juicing several of them and mixing the juice with the apple slices for passionfruit crumble.

Closeup photo of an individual portion of apple crumble, just after cooking.

A few other warmers you might fancy:

  • Skud’s apple and oat crumble for breakfasts.
  • Tom yum goong can go either way, seasonally, but at this time of year if you make it spicy enough it will warm most of the lower half of your face.
  • Lemon delicious pudding, another great dessert to make in one container or individual portions.

What’s warming you, this winter?

On opting out

Captain Awkward has a thread on lateness and keeping in contact with people who are constantly late or no-shows. Her answer is worth reading, because she takes both sides seriously: the way being late feeds into anxiety or depression disorders sometimes (and has for her), and the way to structure social engagements with people who are in that place (whether due to mental health issues or not, it doesn’t require disclosure).

She’s specifically asked that people who are good with time and todo lists (I am, relatively) not drop in with “handy hints”, which is fair enough, but now I’m finding some of the”just loosen up, I have rejected our culture’s terrible clock ticking obsession, and I think that makes me a better person” (uh, paraphrased) comments irritating. I’m posting here rather than there because of the relative privilege of being good with my culture’s approach to time, though.

However, opting out is also a pretty privileged thing to do, honestly. Here’s the big clock related things I can’t opt out of, right now: my son’s childcare, who (like most) fine about $1 a minute for late pickups. Moreover, those people also have children to pick up and errands to run, so a significantly late arrival from me would ruin at least three families’ evenings. (Two staff members are required on premises at all times, so one late parent is two late workers.)

Parenting is by no means the only type of problem here too (look at some writings on spoon budgeting some time: what happens when you are an hour late for someone who set aside spoons to see you?) but it’s a pretty typical set of examples. So are people who work in a great number of jobs, especially low pay and insecure jobs.

You can be over-scheduled in a privileged way (racing from piano lessons to dinner parties), but you can be over-scheduled without that (racing from end of shift to the hard childcare deadline to the hospital’s visiting hours to the mechanics for the 6th car repair this season), too. So, I find it difficult to respond to a fairly simple analysis of “I figure that half an hour doesn’t matter that much, or shouldn’t! We all survived before mobile phones [or clocks]! Just say no!” When your needs are dictated by other people armed with clocks and mobile phones, there may not be an exit sign visible.

There are a lot of living cultures with looser time constraints than the one I live in. (People talk about a “polychronic-monochronic” axis of cultures, which Wikipedia tells me is due to the anthropologist Edward Hall.) There are ways to systemically structure things so that half an hour doesn’t matter that much. But, when you don’t live in such a culture or can’t stay in one, it’s just not that easy. But when is “just say no” ever the solution to anything serious?

More falsehoods programmers believe about time

Noah Sussman has Falsehoods programmers believe about time, including:

All of these assumptions are wrong

  1. There are always 24 hours in a day.
  2. Months have either 30 or 31 days.
  3. Years have 365 days.
  4. February is always 28 days long.
  5. Any 24-hour period will always begin and end in the same day (or week, or month).

As is usual with these kinds of things, he’s only scratching the surface (even though there’s a lot more than in that excerpt). Andrew and I came up with several more already, on the subject of timezones:

  1. All timezones are vertical lines around the globe evenly spaced in 15 degrees intervals.
  2. All timezones are a whole number of hours offset from UTC.
  3. All timezones are no more than 12 hours offset from UTC.
  4. Two cities within some sufficiently small distance must be in the same timezone.
  5. Two cities with the same longitude must be in the same timezone.
  6. A city further to the east of another city must have a time ahead of or equal to the more western city.
  7. There will only be one timezone within any political boundary.
  8. Within a sufficiently large political boundary, there will be different timezones.
  9. Timezone designations like ‘EST’ are unambiguous.*
  10. Daylight savings shifts occur on the same day around the globe.
  11. Or at least within a hemisphere.
  12. Or at least within a continent.
  13. Or at least within a nation.
  14. Daylight savings shifts occur on predictable dates announced ‘sufficiently far’ in advance that there can be an exhaustive listing of them accurate for the next couple of decades.
  15. Well, at least the next few years.
  16. OK, surely at least this month?

* Both Australia and the United States call their east coast timezone this in winter, and guess what: it’s never the same time in New York as it is in Sydney, and the daylight savings status is seldom the same either. (If you’ve seen Australians call it ‘AEST’, well, yes, we do. Sometimes.)

Paul Offit's Vaccines course

People in my research group have been understandably excited about, eg, Andrew Ng’s online machine learning course (you can also do Natural Language Processing with Dan Jurafsky and Chris Manning, respectively co-authors of Speech and Language Processing and Foundations of Statistical Natural Language Processing, so you need never choose between NLP textbook authors again).

Since submitting my PhD — I never mentioned that here, sorry, but if you follow me anywhere else you’ve probably heard! It’s under examination presently — I’ve zoned out some and eventually decided to head on over to Coursera and see what was on offer, in case I went two weeks without computer science and had withdrawal I guess. There’s nothing that exactly lines up with my desired enrollment dates right now, so instead, I’m in Paul Offit’s Vaccines course, starting June 25. Looking forward to it! Apparently there will be “challenging” assessment quizzes: I’m hoping to write up anything particularly interesting that comes up in the course, although I suspect that for people familiar with Offit’s various books and lectures (I’m not) it may be something of a repeat.

Note: never say never I guess, but anti-vax comments are unlikely to be published.

Useful LaTeX packages: linguistic examples

This is the conclusion of a short series of entries on LaTeX packages I found useful while preparing the examination copy of my PhD thesis.

Today’s entry is a package for displaying linguistic examples (ie, samples of text which you then want to discuss and analyse).  The LaTeX for Linguists Home Page is a good general resource for linguists and computational linguists using LaTeX. I discuss gb4e here because I had to do some messing around to get it to display example numbers the way I want (and the way my supervisor wanted: he likes in-text references to look like “example (4.1)” rather than “example 4.1”), and to get it to work with cleveref, and no one seems to have written that up to my knowledge.

gb4e

gb4e is a linguistic examples package.

usepackage{gb4e}

Input looks like:

begin{exe}
ex This is an example sentencelabel{example}
ex This is another example sentence.
end{exe}

This is a cleveref reference to cref{example}.
This is a normal reference to example (ref{example}).

You can mark sentences with * and ? and so on:

begin{exe}
ex[*] {This is an sentence ungrammatical.}
ex[?] {This is an questionably grammatical sentence.}
end{exe}

You can do sub-examples:

begin{exe}
ex This is an example.
ex
begin{xlist}
ex This is a sub-example.
ex This is another sub-example.
end{xlist}
end{exe}

A few things to do to make gb4e play really nicely. First, some cleveref config. gb4e doesn’t yet automatically tell cleveref how to refer to examples, so you need to tell it that the term is “example”, and second, if you want braces around the number (“example (1.1)” rather than “example 1.1” you need to tell it to use brackets:

% tell cleveref to use the word "example" to refer to examples,
% and to put example numbers in brackets
crefname{xnumi}{example}{examples}
creflabelformat{xnumi}{(#2#1#3)}
crefname{xnumii}{example}{examples}
creflabelformat{xnumii}{(#2#1#3)}
crefname{xnumiii}{example}{examples}
creflabelformat{xnumiii}{(#2#1#3)}
crefname{xnumiv}{example}{examples}
creflabelformat{xnumiv}{(#2#1#3)}

Also, by default, the gb4e numbering does not reset in chapters. That is, your examples will be numbered (1), (2), (3) etc right through a thesis. You probably want more like (1.1), (1.2), (2.1), (2.2), ie chapter.number. Change to this with the following in your preamble:

% Store the old chapter command so that
% our redefinition can still refer to it
letoldchapterchapter
% Redefine the chapter command so that it resets the
% 'exx' counter that gb4e uses on every new chapter.
renewcommand{chapter}{setcounter{exx}{0}oldchapter}

% Redefine how example numbers are shown so that they are
% chapter number dot example number
renewcommand{thexnumi}{thechapter.arabic{xnumi}}
You could also get it to reset in sections by replacing chapter and thechapter with section and thesection in the above.

Thanks to the TeX Stack Exchange community for their help with this. See Section based linguistic example numbering with brackets for more information.

Useful LaTeX packages: within document references

This is part of a short series of entries on LaTeX packages I found useful while preparing the examination copy of my PhD thesis.

Today’s entry is packages relevant to preparing within document references. These are both fairly new to me, although not absolutely now.

hyperref

This package turns cross-references and bibliography references into clickable links in your output PDF (at least if you generate it with xelatex or pdflatex), without you having to do anything other than the ref (or cleveref’s cref) and cite and so on commands.

usepackage{hyperref}

You will probably want to modify its choice of colours to something more subtle:

usepackage[citecolor=blue,%
    filecolor=black,%
    linkcolor=blue,%
    % Generates page numbers in your bibliography, ie will
    % list all the pages where you referred to that entry.
    pagebackref=true,%
    colorlinks=true,%
    urlcolor=blue]{hyperref}

Use black if you want the links the same colour as your text.

One note with hyperref: generally it should be the last package you load. There are occasional exceptions, see Which packages should be loaded after hyperref instead of before?

cleveref

cleveref is a LaTeX package that automatically remembers how you refer to things. So instead of:

see chapter ref{chapref}

you use the cref command:

see cref{chapref}

It handles multiple references nicely too:

see cref{chapref,anotherchapref}

will generate output along the lines of “see chapters 1 and 2”.

Use

Cref{refname}

to generate capitalised text, eg “Chapter 1” rather than “chapter 1”

To use it:

usepackage{cleveref}

It shortens the word “equation” to “eq.” by default, if you don’t like that, then:

usepackage[noabbrev]{cleveref}

For some packages that don’t yet tell cleveref how to refer to their counters, you will get output like “see ?? 1” rather than “see example 1”. You use the crefname command in the preamble to tell it what word to use for each unknown counter, examples of crefname will be shown tomorrow for gb4e.

Useful LaTeX packages: tables and figures

This is part of a short series of entries on LaTeX packages I found useful while preparing the examination copy of my PhD thesis.

Today’s entry is packages relevant to preparing tables or figures. Again, some are pretty widely known and some aren’t.

rotating

If you have a big table or figure that should be rotated sideways onto its own page:

usepackage{rotating}

And then you can replace the table and figure commands with:

begin{sidewaystable}
%Giant table goes here
end{sidewaystable}
begin{sidewaysfigure}
%Giant figure goes here
end{sidewaysfigure}

dcolumn

The dcolumn package produces tabular columns that are perfectly aligned on a decimal point (ie all the decimal points in that column are exactly underneath each other), which is usually how you want to display decimal numbers.

usepackage{dcolumn}

% create a new column type, d, which takes the . out of numbers, replacing the .
% with a cdot and aligning on it.
newcolumntype{d}[1]{D{.}{cdot}{#1}}

Now that you have defined the column type, you can use d in the tabular environment, where the numeric argument is the number of figures to expect after the decimal point. You don’t have to use exactly that number of figures in every entry, just that that’s how much room it will leave.

% a tabular enviroment with a 1 and 3 figures after the decimal point column
begin{tabular}{d{1}d{3}}
1.6 & 1.657
\
2.0 & 6.563
\
7 & 6.26
\
end{tabular}

One annoying aspect of this package is that for the headers of that column, which probably aren’t numbers, you will need to use multicolumn to get them to display nicely.

% a tabular enviroment with a 1 and 3 figures after the decimal point column
begin{tabular}{d{1}d{3}}
multicolumn{1}{c}{Heading 1} & multicolumn{1}{c}{Heading 2}\
1.6 & 1.657
\
2.0 & 6.563
\
7 & 6.26
\
end{tabular}

You can mix the d column type with the usual l, r and p column types.

threeparttable

You can’t use footnote in a floating table. This is one of several packages that allow table footnotes in various ways.

usepackage{threeparttable}

threeparttable doesn’t cause tables to float on its own, so you usually want to wrap in a table command:

begin{table}

begin{threeparttable}

% Normal bits of your table go here, and use tnote{a} and
% tnote{b} and so to generate a note mark

begin{tablenotes}
tnote General note
tnote General note 2
tnote[a] Note for mark a
tnote[b] Note for mark b
end{tablenotes}

end{threeparttable}

caption{Caption goes here}
end{table}

Unfortunately you need to generate the a, b, c (or whatever) numbering manually.

The general tnote entries are useful for things like “Bold entries are highest in the column”, so that they don’t need to go in the caption.