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
// 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
- Funcions
- Cites en un estil de citaBibliografia a partir de les referènciesNotes dels llibres japonesosNotes a peu de pàginaPeus numeratsFigura i Taula en la teva llenguaEstil de taulesEstil dels peusFigures i taules com a recursosFigures just aquíTítols numeratsTítols que ocupen línies del text (gyōdori)Una o dues columnesRetícula de caràctersObertures dissenyadesEstils de títolFonts xineses, japoneses i coreanesChips en líniaCapçaleres i folisExportació a PDF
- També fa servir
- RequadresTall de línies en xinèsEquilibri de columnesReferències creuadesAtributs de títolCapçaleres segons el tipus de pàginaEstils de paràgrafFonts incrustades al PDFTipus de recurs propisPreliminars en romansTaules a partir de dadesSalts de línia als títolsCapítols sense número
- 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.

#3 · El títol sobre la banda de la revista
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
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
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
// ═══ 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
familyigiven, o com un solliteralsense 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
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


