Saltar al contingut principal
Recepta número 125

Receptari · Capítol 5 · Estructura del llibre

Un article de recerca japonès citat segons la SIST 02

Una nota de recerca japonesa en A4 a dues columnes: citacions [@clau] numerades (1), (2, 3) segons la SIST 02, una llista 参考文献 en japonès, notes, 表1 i 図1.

En aquesta pàgina
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 297 mm
  • 2 columnes, espai entre columnes de 6,3 mm
  • Noto Serif JP 9/15,5
  • Noto Sans JP
  • Shippori Mincho B1
  • 2 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 191 ms
  • 180 línies de codi

En poques paraules

Un article breu d'una revista científica japonesa. L'autor escriu un codi per a cada font; Postext les numera per ordre de citació i compon la llista de referències com la demanen les revistes científiques japoneses.

Què compondràs

Dues pàgines d'una nota de recerca, 号数活字の三つの系列 («Les tres sèries de cossos gōsū»), d'una revista inventada sobre tipus i composició, compostes com componen les seves revistes les societats acadèmiques japoneses: A4, dues columnes de 25 caràcters per 45 línies de Noto Serif JP de 9 pt, i el títol en Shippori Mincho B1 sobre la banda verda de la revista. Les citacions segueixen la SIST 02, la guia de referències de les revistes japoneses de ciència i tecnologia. Cada obra es numera per l'ordre en què se cita per primera vegada, (1), (2, 3), i la llista sota 参考文献 dona els noms japonesos amb el cognom davant, el lloc abans de l'editorial i l'any al final. Una taula dels nou cossos, una figura que els dibuixa a escala i dues notes a peu de pàgina porten rètols japonesos. L'article xinès citat segons la GB/T 7714 n'és l'equivalent en xinès.

Aquesta recepta respon a

  • Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?
  • Com componc les notes d'un llibre japonès: (1) al final del capítol, al peu de la pàgina o al costat del text a la doble pàgina?

La resposta curta

script.js · línies 32–45al codi complet
// Register the engine once, before the first build. SIST 02, the standard Japanese science
// and technology journals cite to, numbers works in the order they are first cited; the
// ja-JP locale writes the list's words and joins authors with と and ほか. The document's
// own locale 'ja' gives the notes their Japanese defaults: at the foot of the column,
// numbered per page, a superscript marker and a rule a third of the column.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'sist02',
  locale: 'ja-JP',
  bibliography: { fontSize: em(8 / BODY), lineHeight: pt(13), entrySpacing: pt(1),
    labelWidth: em(2.2) }, // turnovers under the text of the entry, past the (n)
};
const footnotes = { fontSize: pt(7.5), lineHeight: pt(11.5), color: col('ink'),
  separator: { color: col('rule') } }; // placement, numbering and marker: the 'ja' defaults

Ingredients

Tipografia
Noto Serif JP, Noto Sans JP, Shippori Mincho B1 (SIL OFL 1.1)
Recursos
  • Figure 1, the three series of type sizes, drawn in code to scale (Postext Cookbook, CC BY 4.0)

Elaboració

#1 · L'estil, la locale i les notes

El codi és la resposta curta de més amunt. postext-citeproc porta la SIST 02 com a 'sist02' i la locale CSL ja-JP, que escriu en japonès els termes de la llista i, en una citació narrativa, uneix dos autors japonesos amb と i més de dos amb ほか (Cites). Al text, [@kawada1949; @suzuki2015] imprimeix (2, 3), i 高橋[@takahashi2012]が posa el número després del nom, 高橋(8)が, que la pàgina compon amb un quart de quadratí a cada costat del parèntesi, com al voltant de qualsevol paraula occidental en un text japonès. L'estil es distingeix de la GB/T 7714 xinesa per la crida: la SIST 02 posa el número entre parèntesis a la línia, i la GB/T 7714, entre claudàtors i volat. Les notes no necessiten res: locale: 'ja' dona a un document horitzontal notes a peu de columna, numerades des d'1 a cada pàgina, amb la crida volada i un filet d'un terç de la columna.

#2 · Les referències en un bloc CSL-YAML

Les obres van al final del Markdown dins :::references{format=csl-yaml}, el format que Zotero exporta com a CSL YAML (Citar). Els noms japonesos entren com a family i given, {family: 鈴木, given: 広光}, i la SIST 02 els imprimeix junts, 鈴木広光, mentre que Kornicki conserva la coma: Kornicki, Peter. Una col·lecció va a collection-title i surt entre parèntesis després de l'any. Els dos articles de 日本印刷学会誌 donen el volum, el número i les pàgines com a vol. 49, no. 2, p. 76–80. Totes les obres són reals, i les seves fitxes es poden comprovar a CiNii.

Pàgina 24: les entrades (3) a (9), amb el cognom japonès davant, el lloc abans de l'editorial i l'any al final.

#3 · El títol sobre la banda de la revista

script.js · línies 49–71al codi complet
const BAND = 78; // mm from the trim's top: the title sits on the journal's green
const at = (id, y) => ({ anchor: { to: `#${id}`, edge: 'below' }, offset: { y: mm(y) },
  size: { width: mm(AREA) } });
const line = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(color), align: 'center',
  overflow: 'wrap', placement, ...extra });
const top = (y) => ({ anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(y) },
  size: { width: mm(AREA) } });
const masthead = { enabled: true, minHeight: pt(10 * PITCH), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('green') },
    placement: { anchor: { to: 'page', edge: 'top-left' },
      size: { width: 'fill', height: mm(BAND) } } },
  line('journal', '活字と組版の研究', GOTHIC, 13, 'paper', top(-13), { fontWeight: 700,
    align: 'left', letterSpacing: pt(2) }),
  line('issue', '第12巻 第2号(2026)', GOTHIC, 8, 'mist', top(-12), { align: 'right' }),
  line('kind', '{attr.kind}', GOTHIC, 8, 'mist', top(2), { fontWeight: 700,
    letterSpacing: pt(2) }),
  line('title', '{titleText}', TITLE, 20, 'paper', at('kind', 3), { fontWeight: 700,
    lineHeight: 1.45 }),
  line('english', '{attr.english}', MINCHO, 8.5, 'mist', at('title', 3)),
  line('author', '{attr.authors}', MINCHO, 11, 'ink', top(BAND - 16)),
  line('affiliation', '{attr.affiliation}', MINCHO, 8, 'muted', at('author', 1.5)),
] } };

El bloc de títol és el disseny de l'H1, un estil d'encapçalament que travessa les dues columnes. La banda és una caixa ancorada al tall. L'etiqueta, el títol i la traducció anglesa hi van a sobre, cadascun sota l'anterior, de manera que un títol de tres línies empeny cap avall la línia anglesa. L'autora i la seva filiació surten d'atributs del títol i van sota la banda.

#4 · El resum i les seves etiquetes

script.js · línies 75–82al codi complet
const calloutStyles = [{ id: 'abstract', span: 'page', backgroundEnabled: false,
  stripe: { enabled: true, side: 'top', width: pt(1.5), color: col('green') },
  padding: { top: mm(2.5), bottom: mm(2.5), left: em(2), right: em(2) },
  marginTop: pt(0), marginBottom: pt(PITCH),
  body: { fontFamily: MINCHO, fontSize: pt(8.5), lineHeight: pt(14), firstLineIndent: pt(0),
    textAlign: 'justify' } }];
const chipStyles = [{ id: 'label', fontFamily: GOTHIC, bold: true, color: col('green'),
  backgroundEnabled: false, borderWidth: pt(0), paddingX: em(0), gap: em(1) }];

El resum és un requadre a tota l'amplada sota una franja superior verda, i les etiquetes són xips en gòtica negreta del color de la revista. Un espai ideogràfic després de cada etiqueta, escrit al Markdown, separa 要 旨 del text.

#5 · 表1 i 図1 on se citen

script.js · línies 279–301al codi complet
const SIZES = `号数\t旧号数(pt)\t新号数(pt)\t系列
初号\t42\t42\t初号系
一号\t27.5\t26.25\t一号系
二号\t21\t21\t初号系
三号\t16\t15.75\t三号系
四号\t13.75\t13.125\t一号系
五号\t10.5\t10.5\t初号系
六号\t8\t7.875\t三号系
七号\t5.25\t5.25\t初号系
八号\t4\t3.9375\t三号系`;
const SERIES = [[42, 21, 10.5, 5.25], [27.5, 13.75], [16, 8, 4]]; // old values, pt
const resources = [
  { id: 'tbl:sizes', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
    placement: { position: 'here' },
    caption: '号数活字の大きさ。新号数はJIS Z 8305(1962)による',
    table: { model: { ...parseTSV(SIZES), headerRowCount: 1, columnWidths: [16, 28, 28, 28] } } },
  { id: 'fig:series', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
    placement: { position: 'here' },
    caption: '号数活字の三つの系列。上から初号系、一号系、三号系。正方形は旧号数の大きさを実寸で示す',
    altText: 'Three rows of squares drawn to scale: 42, 21, 10.5 and 5.25 pt; 27.5 and 13.75 pt; '
      + '16, 8 and 4 pt. Each square is half the one before it.',
    svg: { fileId: 'series.svg', width: 790, height: 520 } },
];

defaultResourceTypes('ja') dona 図 i 表. L'article els numera seguits, 表1 i 図1, no per capítol, així que la plantilla és '{n}'. Tots dos van a 'here', sota el paràgraf que els cita, dins de la columna. Els quadrats de la figura es dibuixen a la mida del tipus que representen, de 42 pt per al 初号 a 4 pt per al 八号, i a la pàgina es veu com cada pas redueix la mida a la meitat.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 125 · A Japanese research paper cited to SIST 02 ═══════════
// https://postext.dev/en/cookbook/sist02-research-paper
// Code: MIT · Text: original (CC BY 4.0) · Pictures: drawn in code
// Fonts: Noto Serif JP, Noto Sans JP, Shippori Mincho B1 (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine, defaultResourceTypes,
  parseTSV, registerResourceImage, inlineSvgFonts,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'es'; // @lang: the language of the frame; the paper is Japanese in both
const RECIPE = 'sist02-research-paper';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black text, one deep green for the journal, its rules and its labels
const palette = {
  ink: '#1b1d1c', green: '#1f5a46', mist: '#cfe0d8', rule: '#a7b3ad', muted: '#5d6662',
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.green })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [MINCHO, GOTHIC, TITLE] = ['Noto Serif JP', 'Noto Sans JP', 'Shippori Mincho B1'];
const [BODY, PITCH] = [9, 15.5]; // pt: 9 pt text on a 15.5 pt line
const [CHARS, LINES] = [25, 45]; // characters to a column's line, lines to a column
const PT = 25.4 / 72; // mm in a point
const AREA = (2 * CHARS + 2) * BODY * PT; // mm: two columns and a 2-em gutter, 165

// #region answer: SIST 02 in Japanese: numbered citations, the list under 参考文献
// Register the engine once, before the first build. SIST 02, the standard Japanese science
// and technology journals cite to, numbers works in the order they are first cited; the
// ja-JP locale writes the list's words and joins authors with と and ほか. The document's
// own locale 'ja' gives the notes their Japanese defaults: at the foot of the column,
// numbered per page, a superscript marker and a rule a third of the column.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'sist02',
  locale: 'ja-JP',
  bibliography: { fontSize: em(8 / BODY), lineHeight: pt(13), entrySpacing: pt(1),
    labelWidth: em(2.2) }, // turnovers under the text of the entry, past the (n)
};
const footnotes = { fontSize: pt(7.5), lineHeight: pt(11.5), color: col('ink'),
  separator: { color: col('rule') } }; // placement, numbering and marker: the 'ja' defaults
// #endregion

// #region masthead: the journal, the paper's kind, its title and English title on a band

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Números de citació volats

Moltes revistes japoneses pugen el número per sobre de la línia. marker: 'superscript' l'imprimeix volat, sense parèntesis, i deixa la llista com està.

   locale: 'ja-JP',
+  marker: 'superscript',

#Notes numerades a tot l'article

Un article de poques pàgines pot comptar les notes d'1 fins al final en lloc de fer-ho per pàgina.

-const footnotes = { fontSize: pt(7.5), lineHeight: pt(11.5), color: col('ink'),
+const footnotes = { numbering: 'document', fontSize: pt(7.5), lineHeight: pt(11.5),
+  color: col('ink'),

Errors freqüents

Error freqüent

Etiqueta un text japonès 'ja', mai zh-Hans ni LANG

Les edicions d'una recepta són en i es, però una mostra japonesa és japonesa en totes dues: `locale: LANG` l'etiquetaria com a anglès o castellà, i una etiqueta xinesa la compondria amb les regles xineses (puntuació Kaiming, kana petit lliure de començar línia, 图 en lloc de 図, formes xineses dels caràcters al PDF). Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que qualsevol etiqueta que no sigui 'ja' dona altres formes de glif que les japoneses (les xineses, amb una etiqueta xinesa) i altres talls de línia. Escriu 'ja': tria la regió del Japó (tall i puntuació de la JLReq, punts de sèsam, repartiment dels furigana, etiquetes 図 i 表) i desactiva la partició de mots. El lint falla un text amb kana sota una etiqueta zh o ko. Tall de línies japonès (kinsoku) →

Error freqüent

Compon el japonès amb una font japonesa

Noto Serif SC i TC tenen kana, però dibuixen els kanji amb formes xineses (直, 骨 i 角 canvien) i el kana amb un disseny xinès. Compon el text en Noto Serif JP o Shippori Mincho B1 i els títols en Noto Sans JP, carregades amb loadCjkFonts. Els fitxers japonesos de Fontsource no tenen hentaigana ni altres kana històrics (U+1B000–1B16F): loadCjkFonts hi falla i el PDF imprimeix caixes, així que escriu el kana modern o porta als recursos de la recepta una font que els tingui. Shippori Mincho tampoc no té les vocals amb macró ō i ū: compon el rōmaji amb una font llatina. Kana, kanji i rōmaji →

Error freqüent

Les fonts xineses es carreguen per fragments, amb el bloc cjk

Fontsource serveix una família xinesa, japonesa o coreana en un centenar de fitxers per pes, cadascun amb un interval de caràcters. loadFonts només baixa el fitxer latin, així que a la pantalla els caràcters xinesos surten d'una font del sistema i es mesuren malament, i fontsourceProvider lliura al PDF aquest fitxer latin, que els imprimeix com a caixes buides. Afegeix el bloc cjk del kit, crida loadCjkFonts(FONTS, markdown) després de loadFonts (una vegada per veu, amb el text que compon, si el llibre fa servir diverses fonts xineses) i passa a renderToPdf fontProvider: cjkPdfProvider: tots dos agafen els fitxers que contenen els caràcters del text. Fonts xineses, japoneses i coreanes →

  • Escriu un nom japonès com a family i given, o com un sol literal sense espai. Un nom escrit com una cadena amb un espai entre cognom i nom, com sol arribar de BibTeX (author = {夏目 漱石}), es llegeix amb el cognom davant, però un de romanitzat, Natsume Soseki, es llegeix com a nom i cognom, igual que els noms anglesos.
  • La SIST 02 inclosa no imprimeix el DOI. Si el DOI d'un article importa, posa'l al text o en una nota.

Crèdits

Text
Text original, CC BY 4.0
Imatges
  • Figure 1, the three series of type sizes, drawn in code to scale · Postext Cookbook · CC BY 4.0
Fonts
Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · Shippori Mincho B1 (SIL OFL 1.1)
SandboxPDF