Saltar al contenido principal
Receta número 125

Recetario · Capítulo 5 · Estructura del libro

Un artículo de investigación japonés citado según SIST 02

Una nota de investigación japonesa en A4 a dos columnas: citas [@clave] numeradas (1), (2, 3) según SIST 02, una lista 参考文献 en japonés, notas, 表1 y 図1.

p. 23 · 1 de 2

  • Formato 210 × 297 mm
  • 2 columnas, medianil de 6,3 mm
  • Noto Serif JP 9/15,5
  • Noto Sans JP
  • Shippori Mincho B1
  • 2 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 191 ms
  • 180 líneas de código

En pocas palabras

Un artículo breve de una revista científica japonesa. El autor escribe un código para cada fuente; Postext las numera por orden de cita y compone la lista de referencias como la piden las revistas científicas japonesas.

Lo que vas a componer

Dos páginas de una nota de investigación, 号数活字の三つの系列 («Las tres series de cuerpos gōsū»), de una revista inventada sobre tipos y composición, compuesta como componen sus revistas las sociedades académicas japonesas: A4, dos columnas de 25 caracteres por 45 líneas de Noto Serif JP a 9 pt, y el título en Shippori Mincho B1 sobre la banda verde de la revista. Las citas siguen SIST 02, la guía de referencias que usan las revistas japonesas de ciencia y tecnología: cada obra se numera por el orden en que se cita por primera vez, (1), (2, 3), y la lista bajo 参考文献 da los nombres japoneses con el apellido delante, el lugar antes de la editorial y el año al final. Una tabla de los nueve cuerpos, una figura que los dibuja a escala y dos notas al pie llevan rótulos japoneses. El artículo chino citado según la GB/T 7714 es su equivalente en chino.

Esta receta responde a

  • ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?
  • ¿Cómo compongo las notas de un libro japonés: (1) al final del capítulo, al pie de la página o junto al texto en la doble página?

La respuesta corta

script.js · líneas 32–45en el código completo
// 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

Ingredientes

Tipografía
Noto Serif JP, Noto Sans JP, Shippori Mincho B1 (SIL OFL 1.1)
Recursos
  • La figura 1, las tres series de cuerpos, dibujada en código a escala (Postext Cookbook, CC BY 4.0)

Elaboración

#1 · El estilo, la locale y las notas

El código es la respuesta corta de arriba. postext-citeproc trae SIST 02 como 'sist02' y la locale CSL ja-JP, que escribe en japonés los términos de la lista y une dos autores japoneses con と y más de dos con ほか en una cita narrativa (Citas). En el texto, [@kawada1949; @suzuki2015] imprime (2, 3), y 高橋[@takahashi2012]が pone el número tras el nombre, 高橋(8)が, que la página compone con un cuarto de cuadratín a cada lado del paréntesis, como alrededor de cualquier palabra occidental en un texto japonés. El estilo se distingue del chino GB/T 7714 en la llamada: SIST 02 pone el número entre paréntesis en la línea; la GB/T 7714, entre corchetes y volado. Las notas no necesitan nada: locale: 'ja' da a un documento horizontal notas al pie de la columna, numeradas desde 1 en cada página, con la llamada volada y un filete de un tercio de la columna.

#2 · Las referencias en un bloque CSL-YAML

Las obras van al final del Markdown en :::references{format=csl-yaml}, el formato que Zotero exporta como CSL YAML (Citar). Los nombres japoneses entran como family y given, {family: 鈴木, given: 広光}, y SIST 02 los imprime juntos, 鈴木広光, mientras que Kornicki conserva su coma: Kornicki, Peter. Una colección va en collection-title y sale entre paréntesis tras el año; los dos artículos de 日本印刷学会誌 dan volumen, número y páginas como vol. 49, no. 2, p. 76–80. Todas las obras son reales; sus fichas se pueden comprobar en CiNii.

Página 24: las entradas (3) a (9), con el apellido japonés delante, el lugar antes de la editorial y el año al final.

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

script.js · líneas 49–71en el código completo
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 bloque de título es el diseño del H1, un estilo de encabezado que cruza las dos columnas. La banda es una caja anclada al corte; la etiqueta, el título y su traducción inglesa van sobre ella, cada uno bajo el anterior, así que un título de tres líneas empuja hacia abajo la línea inglesa. La autora y su filiación salen de atributos del encabezado y van bajo la banda.

#4 · El resumen y sus etiquetas

script.js · líneas 75–82en el código completo
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 resumen es un recuadro a todo el ancho bajo una franja superior verde, y sus etiquetas son chips en gótica negrita del color de la revista. Un espacio ideográfico tras cada etiqueta, escrito en el Markdown, separa 要 旨 del texto.

#5 · 表1 y 図1 donde se citan

script.js · líneas 279–301en el código completo
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') da 図 y 表; el artículo los numera seguidos, 表1 y 図1, no por capítulo, así que la plantilla es '{n}'. Los dos van en 'here', debajo del párrafo que los cita, dentro de la columna. Los cuadrados de la figura se dibujan del tamaño del tipo que representan, de 42 pt para el 初号 a 4 pt para el 八号, para que la mitad de cada paso se vea en la página.

La receta 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

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Números de cita volados

Muchas revistas japonesas suben el número sobre la línea. marker: 'superscript' lo imprime volado, sin paréntesis, y deja la lista como está.

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

#Notas numeradas en todo el artículo

Un artículo de pocas páginas puede contar sus notas de 1 al final en lugar de por 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'),

Errores frecuentes

Error frecuente

Etiqueta un texto japonés 'ja', nunca zh-Hans ni LANG

Las ediciones de una receta son en y es, pero una muestra japonesa es japonesa en las dos: `locale: LANG` la etiquetaría como inglés o español, y una etiqueta china la compondría con las reglas chinas (puntuación Kaiming, kana pequeño libre de empezar línea, 图 en lugar de 図, formas chinas de los caracteres en el PDF). Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que cualquier etiqueta que no sea 'ja' da otras formas de glifo que las japonesas (las chinas, con una etiqueta china) y otros cortes de línea. Escribe 'ja': elige la región de Japón (corte y puntuación de la JLReq, puntos de sésamo, reparto de los furigana, etiquetas 図 y 表) y desactiva la separación silábica. El lint falla un texto con kana bajo una etiqueta zh o ko. Corte de líneas japonés (kinsoku) →

Error frecuente

Compón el japonés con una fuente japonesa

Noto Serif SC y TC tienen kana, pero dibujan los kanji con formas chinas (直, 骨 y 角 cambian) y el kana con un diseño chino. Compón el texto en Noto Serif JP o Shippori Mincho B1 y los títulos en Noto Sans JP, cargadas con loadCjkFonts. Los archivos japoneses de Fontsource no tienen hentaigana ni otros kana históricos (U+1B000–1B16F): loadCjkFonts falla con ellos y el PDF imprime cajas, así que escribe el kana moderno o lleva en los recursos de la receta una fuente que los tenga. Shippori Mincho tampoco tiene las vocales con macrón ō y ū: compón el rōmaji con una fuente latina. Kana, kanji y rōmaji →

Error frecuente

Las fuentes chinas se cargan por fragmentos, con el bloque cjk

Fontsource sirve una familia china, japonesa o coreana en un centenar de archivos por peso, cada uno con un intervalo de caracteres. loadFonts solo descarga el archivo latin, así que en pantalla los caracteres chinos salen de una fuente del sistema y se miden mal, y fontsourceProvider entrega al PDF ese archivo latin, que los imprime como cajas vacías. Añade el bloque cjk del kit, llama a loadCjkFonts(FONTS, markdown) después de loadFonts (una vez por voz, con el texto que compone, si el libro usa varias fuentes chinas) y pasa a renderToPdf fontProvider: cjkPdfProvider: ambos toman los archivos que contienen los caracteres del texto. Fuentes chinas, japonesas y coreanas →

  • Escribe un nombre japonés como family y given, o como un solo literal sin espacio. Un nombre escrito como una cadena con un espacio entre apellido y nombre, como suele llegar en BibTeX (author = {夏目 漱石}), se lee con el apellido delante, pero uno romanizado, Natsume Soseki, se lee como nombre y apellido, igual que los nombres ingleses.
  • El SIST 02 incluido no imprime el DOI; si el DOI de un artículo importa, ponlo en el texto o en una nota.

Créditos

Texto
Texto original, CC BY 4.0
Imágenes
  • La figura 1, las tres series de cuerpos, dibujada en código a escala · Postext Cookbook · CC BY 4.0
Fuentes
Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · Shippori Mincho B1 (SIL OFL 1.1)
SandboxPDF