pbs-assess/csas-style

:scroll: LaTeX style file for CSAS research documents

csas-style's Issues

Title for .pdf should be the title of the Res Doc

Travis CI testing

After an exceedingly painful day last week of pushing, tweaking the config script to add one more LaTeX package, and trying again, we now have continuous integration testing for csas-style:
https://travis-ci.org/pbs-assess/csas-style

Also see the front-page/README.md for the badge https://github.com/pbs-assess/csas-style

This will ensure that we don't break the example but we can also use this set up to automatically compile any documents that use csas-style on Travis. If you break it you get a nasty e-mail. :)

@ricardd thanks for the pain of trying a broken example, which made this finally happen.

.bst file should render article titles as sentence case

Currently the CSAS style .bst file is not converting article titles to sentence case. My understanding is that the style file is supposed to leave the title verbatim if the bibliography style requires title case. If the bibliography style requires sentence case than the style file is supposed to squash the unprotected capitals. I believe the CSAS style is sentence case so we should probably be converting the unprotected upper cases to sentence case.

E.g.

@article{saunders1998pollock,
  author  = {M. W. Saunders and W. Andrews},
  year    = {1998},
  title   = {{Walleye Pollock} Stock Assessment for 1997 and Recommended Yield
             Options for 1998},
  journal = {DFO Pacific Stock Assessment PSARC Working Paper},
  volume  = {2009/021},
  pages   = {18~p}
}

should render

Saunders, M.W. and Andrews, W. 1998. Walleye Pollock stock assessment for 1997 and recommended yield options for 1998. DFO Pacific Stock Assessment PSARC Working Paper 2009/021. 18 p.

not

Saunders, M.W. and Andrews, W. 1998. Walleye Pollock Stock Assessment for 1997 and Recommended Yield Options for 1998. DFO Pacific Stock Assessment PSARC Working Paper 2009/021. 18 p.

I wouldn't care too much about this except that it's a pain when I export from Zotero because Zotero does the correct thing and makes the titles title case but not protected unless explicitly protected.

retorquere/zotero-better-bibtex#558

https://tex.stackexchange.com/questions/10772/bibtex-loses-capitals-when-creating-bbl-file/140071#140071

Check out latex package accsupp for Web Accessibility.

Someone should look into this when time. If we can get it working then we should have a submittable Res Doc that won't need any more tweaking by anyone to make it publishable.

The .bst file seems to strip out hyphens from first names

For Redbanded Rockfish assessment, the .bbl file incorrectly strips out hyphens in hyphenated first names. Fixing manually for Redbanded in for Lecomte (2013), both J.-B. and M.-P. Maybe just a quirk of my .bib file, but other .bst files don't seem to mess this up.

I can maybe provide a minimal working example one day. Not a huge issue but I'll note in the readme file.

Ordering of multi-author papers in bibliography

This is the one CSAS (maybe from CJFAS) rule that I couldn't quite automate. Here are some earlier notes; I think it is only (iii) that doesn't quite work correctly.

The ordering of papers for 2 and >2 authors is fiddly and maybe not possible to automate, and so just do manually prior to submission
(edit the order of the .bst file). The CJFAS rules are:

References must be listed in alphabetical order according to the name of the first author and not numbered. References with the same first author are listed in the following order.

(i) Papers with one author only are listed first in chronological order, beginning with the earliest paper.

(ii) Papers with dual authorship follow and are listed in alphabetical order by the last name of the second author.

(iii) Papers with three or more authors appear after the dual-authored papers and are arranged chronologically. These currently get arranged alphabetically (by second, or higher if necessary, author, instead of by year).

For Redbanded I had to manually (in the .bbl file, so don't re-bibtex):

• re-order Edwards et al. (2012 and 2014 order)
• re-order Yamanaka et al. references into chronological order.

Clean up README.md

The README.md file should probably include basic instructions for a user to get started. We should probably move at least some of the current details into a separate file or into the repo's wiki.

Soon we may want to also link to the csasdown repo as an alternative front end to using csas-style. Note that csasdown has some helper functions for installing arial on Windows with add_arial(). Longterm I'd like to get Arial working with tinytex to avoid the MikTeX headaches.

Make this a package

Some folks have had trouble because their directory structure is not correct. We need to make this a package.

Copy notes on 'tips and tricks' from readme file in csas-latex

Should Matt's frontmatter branch be merged into master?

Was on a conference call yesterday and Dan Ricard in Gulf Region mentioned that he was using our csas-style stuff. I think he may have just got an older version of mine, so I was going to let him know that you guys have been extending it. But with the two branches I was just wondering if they should be merged.

And (Sean) if Dan is not a member of pbs-assess then he should still fork it, yes? And if he makes improvements then we would pull them into our master (he can do a pull request). In other words, we don't want to start making outside people members of pbs-assess.

Compare the .bst file (bibliography style file) in Andy's temp branch with what Herring folk are using

It should be almost the same. Then once Herring is submitted we can merge temp branch into master, and get Herring repo to refer to the shared csas-style .bst file. Then we are all using the same .bst file (and I don't have to compare four versions again!).

Update the Readme file as the next Research Document works it's way through CSAP/CSAS.

Please update any rules etc., so that we can minimise the back and forth and get the Res Docs published quicker. Next one may be Andy's POP Appendices.