Catalogue information - step-by-step instructions
This is still in draft
This document explains BCRA's publications catalogues and how to upload data to the
bibliograph pages.
Click/Tap a link or scroll on down.
Catalogues
BCRA's publications – books, periodicals and other occasional items – are
grouped into catalogues. These are listed on our bookshop page, but for a complete "sytem-generated"
listing, see xxxx
Each item in a group, and each article in a periodical, can be assigned a digital
object identifier (DOI) that uniquely identifies it and usually corresponds to a unique
downloadable PDF or other document. The process is not exhaustive because, for example, theBCRA
Review is not (at the moment) split up into individual articles. Also, the DOI process was created
as a demonstration and has not been completed. All this is further discussed below.
The catalogues can be accessed via a shortcut URL so, for example, in bcra.org.uk/cks, cks is a shortcut to the "covers"
page for Cave & Karst Science, which displays a cover image of each issue. At present these
are all on one page, back to the first fully-digitised issue, volume 33(1). Each issue in the
catalogue has its own bibliograph page, a.k.a. contents list. It is called a
bibliograph page because, as part of the listing, it gives a quotable bibliograph string
for each article.
Digital Object Identifiers
In our system, the DOI is also the name of the downloadable PDF. (It should be pointed out
that our DOIs are a special feature of our web site. We have not taken the step of
linking our DOIs to the internationally recognised system at doi.org.
A volunyeer is needed to manage that process. Our DOIs comprise an abbreviation for the catalogue,
followed by three figures presenting the issue number of the periodical or some similar sequence
number, followed by three figures representing the page number of the first page of the article.
Optionally, a '.f' at the end indicates a free download.
Note: the sequence number is not the same as the volume and issue number for
C&KS. For example, volume 49 issue 1 has sequence number 145. The easiest way to find out a
C&KS sequence number is to type something like 49(1) into the "go to volume" text box
on the bibliograph page and then to look at the last three digits of the URL that is displayed.
Even if you ask for an issue in the future, those three digits will be the correct sequence
number, although the issue actually displayed will just be the most recent.
examples
Content Management System
The web pages you view in the various BCRA catalogues are not static pages. They are
not written in an editor, like you would assemble a word document. Instead, the information about
our publications is listed in a set of simple text files (e.g.
this one). These files are essentially a crude form of database, sometimes called a flat-file
database. The format is very similar to that of theEndnote
reference management tool, which you might use when writing scientific papers.
and so on
Adding Data to a Catalogue
To update a catalogue with a new publication, it is not necessary to write any HTML web
pages. As described above, it is only necessary to upload the data to the correctr locations, and
the CMS will look after it. That does not mean that it is trivial – there are still a number
of detailed processes that have to be undertaken. The process is signtly different for the CREG
journal, because that uses an earlier version of the CMS. Here, the process is described for Cave
& Karst Science.
- Download the print-version of C&KS from our web site,
/bcra.org.uk/uploads/CaKS/. It is easier to do
this by FTP than via the actual web site.
- Upload this to our britiag2 cloud server to a location like (e.g.)
/bcra/CKS_originals_to_sort/48-3/Print_PDFs.
- Download from our cloud server britiag1 the files (e.g.)
/dalesbook/CaKS/CaKS48-3_WEBPDFs, which is where, historically, the editor places
them.
- Upload the hires files to our britiag2 cloud server to a location like (e.g.)
/bcra/CKS_originals_to_sort/48-3/Webfiles/hires
- Create a batch file by pasting the directory listing via a command line prompt and then
editing it to reach, e.g.
rename ebook_01_CaKS-48-3-FRONTCOVER.pdf cks144i.pdf
rename ebook_02_CaKS-48-3-INNERFRONT.pdf cks144ii.f.pdf
rename ebook_03_CaKS-48-3-CONTENTS.pdf cks144093.f.pdf
rename ebook_04_CaKS-48-3-EDITORIAL.pdf cks144094f..pdf
rename ebook_05_CaKS-48-3-PAPER1.pdf cks144095.pdf
rename ebook_06_CaKS-48-3-PAPER2.pdf cks144097.pdf
rename ebook_07_CaKS-48-3-PAPER3.pdf cks144101.pdf
rename ebook_08_CaKS-48-3-PAPER4.pdf cks144115.pdf
rename ebook_09_CaKS-48-3-PAPER5.pdf cks144121.pdf
rename ebook_10_CaKS-48-3-FORUM.pdf cks144129.pdf
rename ebook_11_CaKS-48-3-INNERBACK.pdf cks144iii.f.pdf
rename ebook_12_CaKS-48-3-BACKCOVER.pdf cks144iv.pdf
pause
which shows how to rename the supplied files to their DOI names. Run the batch file
and check the output. Not only is a batch file faster and less prone to typos but, if you do get
it wrong, you can simlpy re-run it and there is less chance of getting in a total muddle.
- Merge the individual PDFs together to form a single file and name it cks###000.pdf
where ### is the sequence number for the issue.
- Upload those renamed files to our britiag2 cloud server to a location like (e.g.)
/bcra/PDF-web-mirror/bcra/public-html/pub/candks/_pdf
- Take the abstracts file, supplied by the editor, and edit it to produce the required
and so on. Include...
- sandbox
- layman and supplement
- free issue
- %Z values are 'openAccess' and 'summary'
- html entities
- Upload to /public_html/pub/candks/data
-
temp_front_cks144_h630.tif
temp_rear_cks144_h630.tif
j144_w1000-h1414-c10.jpg
cks144i-w400-ush3333-c5.jpg
j144.jpg
j144_facebook.jpg
- Upload those to /public_html/pub/candks/covers
- Upload PDFs to /public_html/pub/candks/_pdf
- Check for errors - characters, padlocks etc
- Update the server file /manifest2020/periodicals_settings.php file in manifest2020
- Update the server file /public_html/pub/schedules.html
- Update the server file /public_html//pub/pricelist.html if necessary
- For catalogues other than CREGJ, CKS and REVIEW, update the 'latest' setting in
/public_html/pub/pub/covers
- For catalogues other than CREGJ, CKS and REVIEW, update the info in
/public_html/bookshop/__publication_dates
- For CKS catalogue only, update the file at
http://caves.org.uk/payments/bca/forms/M1a.js
- Check the live pages...
- Final check and remove sandbox
- Test the Facebook scrape by posting a message quoting the URL bcra.org.uk/cks,
whereupon Facebook should grab the image that you prepared and uploaded above.
