Goshuin Ledger

Keeping goshuin in a spreadsheet: the columns to use, and three places it breaks

Start from ten columns: the six any goshuin record needs (visit date, shrine or temple, where the photo is, your note, book, page) plus the reading of the name, the visit date in its Japanese era, a row number, and how sure you are of the date. The two that belong to the spreadsheet rather than to the record — the row number and how sure the date is — get filled the moment you add the row. Three things break later: the photos stop matching their rows, era dates sorted as text come out in the wrong order (令和2年 lands before 令和元年), and the book-and-page order cannot be restored after a sort. Sort only on a Western-calendar column written as 2019-05-01, put book and page in as bare numbers, and give every row a number that never changes, and all three stay away.

Published: (last updated: ) by 友田 陽大 (the developer of Goshuin Ledger)

The key points of this article

  • Ten columns carry it: row number, book, page, visit date (Western and Japanese era), shrine or temple, reading, how sure the date is, where the photo is, and your note.
  • Tie a photo to its row with something that survives a sort — the row number or the capture time — never with the position it happens to sit in.
  • Sorting an era date as text puts 令和2年 before 令和元年, so sort on the Western-calendar column instead.
  • Put book and page in as bare numbers, select the whole table, and sort on book then page to get back to the order of the pages.
  • A spreadsheet is the better fit if you want counts and totals, or want to read the whole list on a computer screen.

This article covers two things only: which columns to use when you build a list of your goshuin in a spreadsheet, and the three places it breaks once you have built it. How to drive the spreadsheet itself, and what any particular shrine or temple offers, are outside it.

Which columns do you use?

Ten: row number, book, page, visit date (Western), visit date (Japanese era), shrine or temple, reading, how sure the date is, where the photo is, and your note. That is the six things any record of a goshuin needs — visit date, shrine or temple, photo, note, book, page — with four more on top: the reading, the era date, a row number, and how sure the date is.

Which fields are worth keeping at all is in the fields you can add later and the ones you cannot, and what a list lets you look back at is in how to think about holding your records as one list. Here it is only the decisions you make when those fields become spreadsheet columns.

Column Example value The rule
Row number 12 One per row. Number them in the order you enter them, and never rewrite them
Book 2 The number alone. Not "book 2"
Page 7 The number alone. For a spread, the page it starts on
Visit date (Western) 2019-05-01 Four-digit year, two-digit month, two-digit day, every time
Visit date (Japanese era) 令和元年5月1日 Copy it exactly as it is written on the goshuin
Shrine or temple (the name) Write the same place the same way every time
Reading (the reading of the name) In kana. What you look the row up by when the kanji will not come back to you
How sure the date is Certain One of certain, estimated, unknown
Where the photo is 12.jpg Give it the same name as the row number
Note Rainy day. Pre-written sheet You can add to this at any time

Those are the eight columns a list needs, plus two — the row number and how sure the date is — that carry a value on every single row. The habit of pushing anything you write on some days and not others into the note does not change.

You do not have to fill all ten from the first row. The two that belong to the spreadsheet rather than to the record, the row number and how sure the date is, get filled the moment you add the row: a number assigned after a sort no longer records the order you entered things in, and how sure a date is can only be marked while you still remember where the date came from. Book and page can wait, on the same rough guide the article on choosing fields gives, until your goshuin book reaches its second volume. The era date, the reading and the note can all be added later.

The column for how sure the date is exists to record where the date came from. A date you confirmed against the page and a date you entered provisionally from when the photo was taken look identical in a spreadsheet, and a few years on you cannot tell them apart. Keep three values — certain (confirmed against the date on the goshuin), estimated (taken from the capture date or the photos either side), unknown — and you can narrow the sheet down to exactly the rows worth checking again. Every row carries one, which is why it is a column rather than something buried in the note. How to gather the clues for an estimate is in tracing the visit date of a goshuin that carries no date.

Where does a goshuin spreadsheet break?

In three places: the photos stop matching their rows, sorting on the era date puts the pages in the wrong order, and after a sort you cannot get back to the order of the book and its pages. None of them shows while the sheet is short, and by the time you notice there are more rows to fix.

Breakage 1: the photo and the row come apart

The sheet and the photos live in different places, so unless the sheet carries a way of getting from a row to its photo, you will be hunting one photo at a time. You know perfectly well that row 12 is the goshuin from a particular shrine, and you still open photo after photo from around that date in your photo app — once for every row.

Matching by position — "twelfth from the top in the photo app" — is the easy way, and it drifts the moment you delete one photo or insert one row, with nothing to tell you where the drift started. What you want as a handle is something that survives a sort, and survives deleting another row or another photo.

How to write where the photo is Example Suits Weak point
The row number as the file name 12.jpg Keeping the photos in a folder on a computer Renaming them all takes work
The capture time 2019-05-01 14:02 Leaving the photos in the photo app on your phone Photos taken in the same minute are hard to tell apart

Some spreadsheets let you put an image inside a cell, but at a few hundred photos the spreadsheet file itself tends to get heavy. Keeping the photos outside the sheet and only their whereabouts inside it lasts longer.

Breakage 2: sorting on the era date scrambles the order

Sort an era date as text and you do not get the order you visited in. Where the program compares text one character at a time from the start, year 10 lands before year 9, and month 12 before month 4.

The order visited The order sorting the era text gives
平成9年4月2日 (Heisei 9) 平成10年5月3日 (Heisei 10)
平成10年5月3日 (Heisei 10) 平成31年4月28日 (Heisei 31)
平成31年4月28日 (Heisei 31) 平成9年4月2日 (Heisei 9)

Reiwa does the same: 令和2年 comes before 令和元年, the first year of an era being written 元年 rather than with a numeral. Some programs can read an era date as a date, but which ways of writing it they accept differs from program to program.

The way round it is to sort on the Western-calendar column only, and treat the era column as the one you hold up against the page. Written as 2019-05-01, with a four-digit year and two digits each for month and day, that column sorts correctly whether the program treats it as dates or as plain text.

To convert an era year, count 元年 as year 1 and add 2018 for Reiwa, 1988 for Heisei, 1925 for Showa. The changeover years are the ones addition alone cannot settle: 2019 is Heisei 31 up to April 30 and Reiwa 1 from May 1, so if 平成31年5月 or 令和元年4月 turns up in your sheet, suspect a misreading or a bad conversion. The days the eras changed, and why records slip there sets those dates out as a table, the Showa-to-Heisei boundary in 1989 included.

Breakage 3: you cannot get back to the book-and-page order after a sort

Getting a sheet you sorted by visit date back into the order of the pages needs two things to be true: book and page are in as numbers, and you had the whole table selected when you sorted. Miss either one and it goes like this:

  1. The book is written out as text — "book 1", "book 2", "book 10". Compared a character at a time, book 10 lands before book 1. Put book and page in as numbers alone.
  2. You selected a single column and sorted that. Depending on the program and on what you selected, only the column you picked moves, and the shrine name and the photo beside it stay where they were. The contents of one row end up belonging to different goshuin while the sheet still looks perfectly tidy, which is why this is the one noticed late. Always select the whole table before you sort.

To get back, give the sort two keys in order: book, then page. Sorting on the book alone does not order the pages within a book. And if you have that column of row numbers assigned in entry order, sorting on it returns the sheet to the way it first stood. If you only want to look at something, a filter leaves the order of the sheet itself alone.

Who is a spreadsheet the better fit for?

Anyone who wants counts and totals, and anyone who wants to take the whole list in on a big screen. Counting entries per year, or how many times you have been to the same shrine or temple, is exactly what a spreadsheet's totals are for, and you can add any column you want to keep for yourself — an itinerary, say. If you already have years of it in a sheet and have not tripped over the three above, there is no reason to change tools.

What this app does with it

Goshuin Ledger, the app I make, holds the fields that match eight of the ten columns above, and ties each photo to a single record from the start. Inside a book the records sit in page order, and a search on the shrine or temple name, its reading, your note, the Japanese-era visit date or the type comes back newest visit first, each result carrying which book and which page it is on. Searching does not move the order inside a book.

The bridge to a spreadsheet is the CSV export, which comes with Ledger Full. One row per goshuin, with the shrine or temple name, the visit date in both its Japanese era and the Western calendar, the book and page, and your note, in a form Excel opens without garbled characters. It differs from the ten columns above in three ways.

  • The book column holds the name you gave the book in the app, not a book number. To sort by book, add a numeric column on the spreadsheet side.
  • There is no row number column and none for how sure the date is. Put the certainty in your note and it stays in the CSV.
  • The photos themselves are not in it, and you cannot open a photo from the spreadsheet. To look back with the photos, use the PDF export.

The columns the CSV holds, and what goes into the PDF and into the copy you make for a phone change, are in the three kinds of file you can export.

A spreadsheet you built cannot be read into this app. If you already have one, there are three ways to go.

  1. Carry on with the sheet. If the three breakages are not troubling you, this is the least work by far.
  2. Leave what you have in the sheet, and record what comes next in the app. Copy across from the exported CSV whichever rows the sheet does not have yet.
  3. Import from the photos again and move over. The names and readings have to be typed in again.

Recording in your first book needs no purchase and has no limit on how many entries it holds. A second book and beyond, adding imported photos to a book all at once, and PDF / CSV export come with the one-time Ledger Full. The App Store shows the current price. What the purchase covers is set out in the pricing section of this site. It runs on iPhone with iOS 16.4 or later. It does not sync between devices, so to read your records on a computer you open an exported CSV or PDF.

One thing left over: why records are held in units of books and pages at all is written up separately, as keeping your books from running together as they multiply.

Frequently asked questions

Excel, Numbers or Google Sheets — which should I build it in?
Any of them; the ten columns work unchanged in all three. The thing to choose on is which one opens most easily on the device you will be typing into most often. So that moving between programs later costs you nothing, write the Western-calendar visit date as 2019-05-01: even if the next program reads that column as plain text rather than as dates, it still sorts in the right order.
I already have a few hundred rows. Should I rebuild the sheet in this shape?
There is no need to rebuild it. If you add anything, add two columns: a row number, numbered in the order the sheet already sits in, and a Western-calendar visit date. The number gives you both the handle for matching photos to rows and the way back to the original order, and the Western column is what you sort on, so between them they head off most of the three breakages. Fill in the reading only for the rows that give you trouble when you look something up, and start marking how sure the date is from the rows you add from now on.
What if one goshuin has two or more photos?
Keep it on one row and write both names in the photo column (12-1.jpg and 12-2.jpg, say). Splitting it into two rows turns one goshuin into two as soon as you count them. This is what you do when you photographed a spread as two shots, or added a close-up of the writing.
Can I leave the visit date empty on the rows where I do not know it?
It is easier to work with if you enter the closest date you can get from the pages around it or from when the photo was taken, and mark how sure you are as an estimate, rather than leaving it empty. In most programs the empty rows collect at one end when you sort, and you lose the clue of which visits came before and after. Make one rule of your own — if you only know the month, enter the first day of that month — and leave empty, marked unknown, only the rows with no clue at all.
Can I keep the sheet going on a phone alone?
You can, but ten columns do not fit on the screen, so you will be scrolling sideways as you type. Splitting the job stops it stalling: on the phone enter only the row number, the visit date, how sure it is, and the shrine or temple, and fill the rest in on a computer.