PBIBTEX(1)

🎀 NAME 🎀

pbibtex, upbibtex — bestie's here to make you a (Japanese) bibliography for (La)TeX 💖

---

✨ SYNOPSIS ✨

pbibtex [options] auxname[.aux]

---

🌸 DESCRIPTION 🌸

okay so picture BibTeX but it went to Japanese school and came back thriving — that's pBibTeX (pbibtex). It's a modified version of BibTeX made specifically for Japanese handling, and it sorts entries according to code points in EUC-JP. She also brought a brand-new built-in function called is.kanji.str$ that checks whether an entry is outside ASCII. no cap, that's her whole thing 💅

Then there's upBibTeX (upbibtex), which is a modified version of pBibTeX and sorts entries according to code points in Unicode. Glow up, honestly 🦋

---

🌈 Extensions to Bibliography Style Functions 🌈

so there's one new built-in function on the scene, and a few of the old faves got a lil makeover to make Japanese handling way simpler. periodt ✨

• is.kanji.str$ — [New feature 🆕] Pops the top (string) literal and peeks at it to see if it contains any non-ASCII characters. If it does (at least one, bestie), it pushes 1. If it doesn't, it pushes 0. iconic.
• substring$ — Modified so she never, ever divides a character string right in the middle of a multibyte character. we don't do that here 🫶
• text.prefix$ — same glow-up as substring$ up above, described the exact same way.
• add.period$ — Modified to prevent appending . after Japanese punctuations corresponding to !, ? and . (e.g. U+FF01, U+FF1F, U+3002 and U+FF0E). no double punctuation energy, we're not doing that 😭
• format.name$ — Modified to accept Japanese zenkaku ideographic space (U+3000) for names displayed in Japanese. She's also been modified to recognize Japanese commas (U+3001 and U+FF0C) similar to and between names. multi-talented fr fr 👑

---

💜 SEE ALSO 💜

• bibtex(1)
• ptex(1)

---

👑 AUTHORS 👑

The Japanese version of BibTeX was originally developed by Shouichi Matsui as JBibTeX, all the way until 1991. It was developed to behave consistently with NTT JTeX when handling legacy Japanese encodings. The old documentations jbibtex.pdf, jbtxdoc.tex, jbtxhak.tex (all available in TeX Live, yes bestie) describe the Japanese handling capability and some additional notes of JBibTeX. throwback era honestly 🕰️

Current (u)pBibTeX is a forked version of JBibTeX, and has replaced the encoding conversion routine with one that is compatible with the (u)pTeX community edition using the ptexenc library. ⚠️ heads up though — the descriptions of encodings in the old documentations j*.pdf (especially Section 3.3 of jbibtex.pdf, such as BIBTERMCODE and BIBFILECODE) are incorrect anymore. don't be fooled 💀

This manual page was written by Hironobu Yamashita. 💖

---

Web2C 2025 · 24 July 2021 — that's the source, version and date bestie, mwah, ty for reading, slay 🎀✨💅