More useful contents for book

[Louis-Backstrom]

This is a similar question to the questions raised in #78, but it would be nice to flesh out the contents page in the book a bit. Currently the page looks like this:

I would like it if possible to have links to each order (for non-passerines) and family (for passerines) so that users can more easily navigate - something like this:

NON-PASSERINES

Anseriformes - Ducks and relatives - Magpie Goose
Galliformes - Chickens and relatives - Australian Brushturkey
Podicepiformes - Grebes - Australasian Grebe
Columbiformes - Pigeons - Rock Dove
Cuculiformes - Cuckoos - Pheasant Coucal
Podargiformes - Frogmouths - Marbled Frogmouth
Caprimulgiformes - Nightjars - White-throated Nightjar
Aegotheliformes - Owlet-nightjars - Australian Owlet-nightjar
Apodiformes - Swifts and Hummingbirds - White-throated Needletail
Gruiformes - Cranes and Rails - Lewin's Rail
Charadriiformes - Shorebirds, Gulls and Auks - Bush Stone-Curlew
Phaethontiformes - Tropicbirds - Red-tailed Tropicbird
Sphenisciformes - Penguins - Little Penguin
Procellariiformes - Tubenosed Seabirds - Wilson's Storm-Petrel
Ciconiiformes - Storks - Black-necked Stork
Pelecaniformes - Pelicans, Herons and Ibises - Australian Pelican
Suliformes - Boobies, Cormorants and Frigatebirds
Accipitriformes - Hawks and relatives - Osprey
Strigiformes - Owls - Australasian Grass-Owl
Coraciiformes - Rollers, Bee-eaters and Kingfishers - Rainbow Bee-Eater
Falconiformes - Falcons - Nankeen Kestrel
Psittaciformes - Parrots and Cockatoos - Cockatiel

--

PASSERINES

Pittidae - Pittas - Noisy Pitta
Ptilonorhynchidae - Bowerbirds - Green Catbird
Climacteridae - Treecreepers - White-throated Treecreeper
Maluridae - Fairywrens and relatives - Variegated Fairywren
Meliphagidae - Honeyeaters - Dusky Honeyeater
Pardalotidae - Pardalotes - Spotted Pardalote
Acanthizidae - Scrubwrens, Thornbills and Gerygones - Brown Gerygone
Orthonychidae - Logrunners - Australian Logrunner
Pomatostomidae - Australasian Babblers - Grey-crowned Babbler
Neosittidae - Sittellas - Varied Sittella
Campephagidae - Cuckooshrikes and Trillers - Ground Cuckooshrike
Cinclosomatidae - Quail-thrushes - Spotted Quail-thrush
Pachycephalidae - Whistlers and Shrikethrushes - Rufous Whistler
Falcunculidae - Shrike-tits - Crested Shrike-tit
Psophodidae - Whipbirds - Eastern Whipbird
Oriolidae - Orioles - Australasian Figbird
Artamidae - Butcherbirds, Woodswallows and relatives - Pied Currawong
Dicruridae - Drongos - Spangled Drongo
Rhipiduridae - Fantails - Willie Wagtail
Corvidae - Crows and Ravens - Torresian Crow
Monarchidae - Monarchs - Leaden Flycatcher
Corcoracidae - Australian Mudnesters - Apostlebird
Paradisaeidae - Birds of Paradise - Paradise Riflebird
Petroicidae - Australasian Robins - Rose Robin
Dicaeidae - Flowerpeckers - Mistletoebird
Estrildidae - Estrilid Finches - Scaly-breasted Munia
Passeridae - Sparrows - House Sparrow
Motacillidae - Wagtails and Pipits - Australasian Pipit
Fringillidae - True Finches - European Goldfinch
Alaudidae - Larks - Australasian Bushlark
Cisticolidae - Cisticolas - Golden-headed Cisticola
Locustellidae - Grassbirds and relatives - Brown Songlark
Acrocephalidae - Reed-Warblers - Australian Reed-Warbler
Hirundinidae - Swallows and Martins - White-backed Swallow
Zosteropidae - White-eyes - Silvereye
Sturnidae - Starlings - Common Starling
Turdidae - Thrushes - Russet-tailed Thrush

[Supplementary list species]

(I've put this in the resources folder - see 7b30b25.

This isn't a perfect solution, as it's probably overdone (especially for groups with only one species in the atlas - e.g. Zosteropidae, Sphenisciformes) but hopefully it can be a starting point toward a more fleshed out contents page. @dbl3raf will no doubt have suggestions on ways we can condense this down. I'm also not sure how straightforward such a change to the page would be (so I'll hibernate this issue as it's not crucial) either. I guess we could add family/order header pages (e.g. Anseriformes.Rmd, Galliformes.Rmd, etc.) before the first species in the group and have some text in there, and then work out how to put them in the contents? That seems like unnecessary text to add to the atlas - I think it would be more ideal to somehow have the contents page entry that links straight to the first species in that group.

Thoughts @jeffreyhanson ?

[jeffreyhanson]

It looks like bookdown -- the R package/framework the atlas is built with -- lets you organise the book into "parts". For example, here's another bookdown book which uses "parts" to group chapters (https://r4ds.had.co.nz/), the parts are shown in grey in the web version of the contents page (e.g. "I Explore"). What do you think about using this "parts" functionality to group the species accounts? For example, we could do: "NON-PASSERINES" and "PASSERINES". Alternatively, we could do "Ducks and relatives", "Chickens and relatives", etc. Unfortunately, we can't do two levels of grouping with parts to my knowledge. What do you think? What grouping system makes the most sense to you?

[Louis-Backstrom]

Using parts sounds brilliant. I think best would be to do it in orders (non-passerines)/families (passerines) as this is pretty typical for bird guides etc and probably most evenly breaks the species up. Simply dividing into non-passerines and passerines doesn't provide us with much extra functionality.

What does @dbl3raf think?

[dbl3raf]

I think the order / family solution is excellent. Where did you get the family descriptors from @Louis-Backstrom? Also not sure why individual species names are being mentioned there?

[Louis-Backstrom]

I think the names come from IOC? That or I made them up myself...

The species names were just the first species taxonomically in said group, if I remember correctly. They aren't necessarily relevant to the final product.