Implement Japanese bibliography rendering style

[ronaldtse]

In relaton/relaton-plateau#15 the PLATEAU pubid has removed the Japanese characters for edition.

For JIS and PLATEAU, we need to implement the Japanese bibliography rendering style. The style referenced by JIS Z 8301:2019 is JIS X 0807 based on ISO 690.

[opoudjis]

Right now the JIS biblio style does exist, it's just severely underspecified. relaton-render will need updates to deal with things like ordinals for editions with a number in the middle. But I need real information about what is expected, in English, and not in flyspeck Kanji screengrab.

[opoudjis]

JIS X 0807 is not a stylesheet, but an ontology, and an unadventurous copy-paste of ISO 690-2:1997, without any specialisation for Japanese. It is absurd to say that this specifies a Japanese bibliography style at all: it is the ISO 690 default, with English-only examples (!!!!!!), and as such, it is already supported in relaton-render by default. At most, we may need to revert from ISO house styling to default ISO 690 styling; but if I'm going to do so, I won't on the basis of this spec.

JIS Z 8301:2019 may have usable information for us. JIS X 0807 does not.

This is the information out of it—all of it stuff we've already done.

Electronic books, databases and computer programs

• Example 1. CAROLL, Lewis. Alice's Adventures in Wonderland [online]. Texinfo ed.2.1. [Dortmund, Ger-many] : WindSpiel, November 1994 [cited 10 February 1995]. Available from World Wide Web : <http : //www. germany. eu. net/books/caroll/alice. html>. Also available in PostScript and ASCII versions from Internet: <ftp//ftp. Germany. EU. net/pub/books/carroll/>.
• Example 2. Meeting agenda [online]. Gif-sur−Yvette (France) : Center dʼEtudes Nuclaires/Saclay, Service de Documentation, March 1991- [cited 30 September 1992]. Updated bimonthly. ASCII format. Available from QUESTEL.
• Example 3. Kirk-Othmer Encyclopedia of Chemical Technology [online]. 3rd ed. New York: John Wiley, 1984 [cited 3 January 1990]. Available from DIALOG Information Services, Palo Alto (Calif.).
• Example 4. AXWORTHY, Glenn. Where in the World is Carmen Sandiego? [disk]. Version for IBM/Tandy. San Rafael (Calif.) : Broderbund Software, 1985. 1 computer disk; 5 1/4 in. Accompanied by : 1986 World Almanac and Book of Facts. System requirements: IBM/Tandy compatibles; 128kB RAM; MS DOS 2.0, 3.0 series; graphics adapter required. Designers: Gene Portwood and Lauren Elliott.

A part of an electronic book, a part of a database, or a part of a computer program

• Example 1. World Factbook [CD-ROM]. [Washington, D. C.] : Central Intelligence Agency, 1990. Spain vital statistics. ID number : CI WOFACT 1206.
• Example 2. ICC British Company Financial Datasheets [online]. Hampton (Middlesex, U. K.) : ICC Online, 1992, updated 3 March 1992 [cited 11 March 1992]. Robert Maxwell Group PLC. Accession no. 01209277. Available from : DIALOG Information Services, Palo Alto (Calif.).
• Example 3. CARROLL, Lewis. Alice's Adventures in Wonderland [online]. Texinfo. ed. 2. 2. [Dortmund, Germany] : WindSpiel, November 1994 [cited 30 March 1995]. Chapter VII. A Mad Tea−Party. Available from World−Wide Web : <http : //www. germany. eu. net/books/carroll/alice 10. html#SEC13>.

An article of an electronic book, an article of a database or an article of a computer program

• Example 1. ZHUKOVSKY, Vladimir ; ITKIN, Vladimir ; and CHERNENKO, Lev. Helicopters over the crater. In Current Digest of the Soviet Press [online]. Columbus (Ohio) : Current Digest of the Soviet Press, 11 June 1986 [cited 14 February 1991]. Accession no. 0008752. Available from DIALOG Information Services, Palo Alto (Calif.).
• Example 2. Belle de Jour. In Magill’s Survey of Cinema [online]. Pasadena (Calif.) : Salem Press, 1985-[cited] 1994-08-04]. Accession no.0050053. Available from: DIALOG Information Services, Palo Alto (Calif.).
• Example 3. MCCONNELL, W. H. Constitutional History. In The Canadian Encyclopedia [CD-ROM]. Macintosh version 1. 1. Toronto: McClelland & Stewart, c1993. ISBN 0-7710-1932-7.

Electronic periodicals

• Example 1. Journal of Technology Education [online]. Blacksburg (Va.) : Virginia Polytechnic Institute and State University, 1989- [cited 15 March 1995]. Semi-annual. Available from Internet : <gopher : //borg. lib. vt. edu : 70/1/jte>. ISSN1045-1064.
• Example 2. Profile Canada [CD-ROM]. Toronto: Micromedia, 1993-. The Canadian Connection. Accompanied by : userʼs guide. System requirements : IBM PC or compatible; MPC Standard CD-ROM drive; DOS 3.30 or higher; 490 kB RAM; MS-DOS Extensions 2. 1 or higher. Quarterly.

Serial articles and other articles

• Example 1. STONE, Nan. The Globalization of Europe. Harvard Business Review [online]. May−June 1989 [cited 3 September 1990]. Available from BRS Information Technologies, McLean (Va.).
• Example 2. PRICE−WILKIN, John. Using the World−Wide Web to Deliver Complex Electronic Documents : Implications for Libraries. The Public-Access Computer Systems Review [online]. 1994, vol. 5, no. 3 [cited 1994-07-28], pp. 5-21. Available from Internet: <gopher://info. lib.uh.edu:70/00/articles/e-journals/uhlibrary/pacsreview/v5/n3/pricewil.5n3>. ISSN1048-6542

Electronic bulletin boards, e-mail conferences and e-mail systems

• Example 1. PACS−L (Public Access Computer Systems Forum) [online]. Houston (Tex.) : University of Houston Libraries, June 1989- [cited 17 May 1995]. Available from Internet: listserv@uhupvml. uh.edu.
• Example 2. Federal Depository Library Program Files (/GO Depository) [online]. Washington, D. C.: Government Printing Office [cited 1995-02-15]. Available from Internet : <telnet://federal. bbs.gpo.gov>.

Email

• Example 1. PARKER, Elliott. Re: Citing Electronic Journals. In PACS−L (Public Access Computer Systems Forum) [online]. Houston (Tex.): University of Houston Libraries, 24 November 1989; 13: 29: 35 CST [cited 1 January 1995; 16: 15 EST]. Available from Internet: <telnet://brsuser@a.cni. org>.
• Example 2. PRITCHARD, Sara. Your Request for Information about ISO Standards. [online]. Message to Margaret MORRISON. 18 February 1995 [cited 3 March 1995]. Personal communication.

[opoudjis]

Next task, since this was not useful: look at the styling of JIS Z 8301:2019.

[opoudjis]

For starters, the bizarre requirement to underline (dotted underline, no less) citations where the JIS standard has been updated from the canonical ISO adoption standard, or is other than the canonical ISO adoption standard, or is the canonical ISO adoption standard ignored in favour of the original ISO standard — will be ignored. That is some sort of semantic annotation of JIS references that will need to be worked out and resolved if someone ever asks for this.

... What... a strange thing to do.

---

JIS Z 8301:2019 is no more help than JIS X 0807: clause 21.5's examples of citations are also English, in their entirety.

Do Japanese standards never cite anything in Japanese?

What I need is a House Style; I need the Japanese counterpart to the Chicago Manual of Style, I need an overview of relevant Japanese grammar, and I need someone who speaks Japanese to do QA. Which I presume is @ReesePlews.

The query particularly that was posed up top, that we don't have "5th edn" included in Plateau identifiers any more, is not going to be addressed in JIS Z 8301: (1) edition numbers are NOT included in ISO or JIS standards under ISO or JIS; and (2) JIS Z 8301 is not where I'm going to find out that the Japanese for "5th edn." is 第5版 (or の第 5 版, I guess, in "X,
5th edn." Especially when all their examples are in English anyway.

Never mind that I'm having to guess what is going on via Google Translate. This is not the professional way of going about this.

This is useless. The useful thing to do is:

1. I implement 第%版 in relaton-render (right now it's English "{{ var1 | ordinal_num: 'edition', '' }} edition", because I had no idea what it was.
2. I introduce editions into Plateau (not JIS) rendering of standards.
3. I generate a bunch of (preferably Japanese language) references in a range of bibliographic types, with the existing ISO-inherited stylesheet, and Reese can tell me what looks wrong.

[opoudjis]

FWIW, the default rendering of a monograph that I test on in relaton-render,

RAMSEY, J. K. and W. C. MCGREW. Object play in great apes: Studies in nature and captivity. In: PELLEGRINI, Anthony D. and Peter Kenneth SMITH (eds.): The nature of play: Great apes and humans [electronic resource, 8vo]. 3rd edition. New York, NY: Guilford Press. 2005. pp. 89–112. https://eprints.soton.ac.uk/338791/. [viewed: September 3, 2019].

is now:

RAMSEY, J. K. と W. C. MCGREW. Object play in great apes: Studies in nature and captivity. PELLEGRINI, Anthony D. と Peter Kenneth SMITH (編): The nature of play: Great apes and humans [electronic resource, 8vo]. 第3版. New York, NY: Guilford Press. 2005. ページ89–112. https://eprints.soton.ac.uk/338791/. [見た: 2019年9月3日].

@ReesePlews how wrong is that?

[opoudjis]

The JIS representation of standards right now is:

standard: "{% if home_standard %}<span_class='stddocTitle'>{{ title }}</span> ,_{{ extent }}{% else %}{{ creatornames }}. <span_class='stddocTitle'>{{ title }}</span> ,_{{ extent }} .  {{ labels['version'] | capitalize }}_{{ edition_raw }}. {{labels['updated'] | capitalize }}_{{date_updated}}. {{status | capitalize}}. {{ authorizer }}. {{ labels['availablefrom'] }}:_<span_class='biburl'>{{ uri }}</span>.{% endif %}"

To spell out:

JIS, ISO: TITLE, PART (optional)

Other Standards: AUTHORS. TITLE, PART (optional). Version EDITION. Updated UPDATE-DATE. STATUS. SPONSOR. Available from: URI.

Version, Updated, Available from can be in Japanese.

So, with Japanese i18n, IETF RFC 3979 is displayed as:

S. Bradner. Intellectual Property Rights in IETF Technology. RFC Series. 入手可能: https://www.rfc-editor.org/info/rfc3979

What I'm getting here is a suggestion that Plateau documents, in Plateau, have optional edition numbers. So presumably,

JIS, ISO, Plateau: TITLE EDITION PART (optional)

Where EDITION will be the newly introduced 第5版 in Japanese, and "5th edn." in English.

So, "PLATEAU Handbook #2 1.0" right now (as a document other than JIS and ISO) renders as:

PLATEAU Handbook #2 1.0, 3D都市モデル標準作業手順書. Version 1.0. 国土交通省. 入手可能: https://www.mlit.go.jp/plateau/file/libraries/doc/plateau_doc_0002_ver01.pdf.

I'm assuming what you want, @ronaldtse , in your cryptically phrased ticket, is

PLATEAU Handbook #2 1.0, 3D都市モデル標準作業手順書. 第1.0版. 国土交通省. 入手可能: https://www.mlit.go.jp/plateau/file/libraries/doc/plateau_doc_0002_ver01.pdf.

Is that what you want? Do you want just the title as with ISO/JIS, so

PLATEAU Handbook #2 1.0, 3D都市モデル標準作業手順書. 第1.0版.

... or what?

[opoudjis]

Italics are still happening in titles, and they shouldn't be.

[opoudjis]

Needed to tell Plateau explicitly to use JIS relaton-render class.

[ronaldtse]

@ReesePlews will also supplement with some guidelines for Japanese bibliography.