Skip to content

Latest commit

 

History

History
192 lines (135 loc) · 5.2 KB

INSTALL.md

File metadata and controls

192 lines (135 loc) · 5.2 KB
title author version date
Installation
Christian Külker
0.1.2
2022-06-24

Github license Github issues Github code size in bytes Git repo size Last commit

Installation

This document describes mainly the installation of the dependencies to create the PDF documents. The PDF documents by itself can be created via a Makefile in the source directory mentioned in the README after the dependencies are installed.

History Of This document

Version Date Notes
0.1.2 2022-06-24 OS explanation, formatting, imakeidx
0.1.1 2022-05-07 Typos, history, version
0.1.0 2020-07-25 Initial release for nihongo 0.1.2

INSTALL.md 0.1.2

  • Migrate multind to imakeidx, multind.sty no longer needed added to future release of nihongo-0.1.3
  • Improve dependency explanation
  • Fix paragraph formatting (too long)
  • Improve code fence formatting, change shell to bash
  • Add installation from source for Lingua::JA::Sort::JIS

INSTALL.md 0.1.1

  • Fix typo TeX Live
  • Make references to Debian similar: Debian version code-name
  • Add history section for INSTALL.md
  • Mark special names
  • Add more OS test info for nihongo-0.1.2
  • Change front matter title

nihongo-0.1.2

Operating System

Debian 10 Buster, Unicode 10 and at least TeX Live 2018.20190227-2 is needed. It also has been tested wit Debian 10 Buster and TeX Live 2021.20210325 as well as Debian 11 Bullseye with TeX Live 2022-20220321. As there have been changes in fonts, this project will not build on older Debian versions.

Dependencies

In addition to the instructions of inihongo-0.1.1 install the font Hanazono Mincho. This font is used for Henteigana. Also the font YOzAb is needed and provided in fonts-yozvox-yozfont. The font AoyagiSosekiFont2 is needed, provided by fonts-aoyagi-soseki. The font KanjiStrokeOrders is provided by fonts-kanjistrokeorders. The font KouzanBrushFontGyousyo is provided by fonts-kouzan-mouhitsu.

aptitude install fonts-hanazono fonts-yozvox-yozfont fonts-aoyagi-soseki \
fonts-kanjistrokeorders fonts-kouzan-mouhitsu

Known Issues

Due to the lack of Unicode 10 support, not all glyphs from the Hentaigana table are printed.

nihongo-0.1.1

Operating System

Debian Buster was used for testing.

Dependencies

multind.sty

While multind.sty is available in texlive-latex-extra under Debian 7 Wheezy it has been removed in recent LaTeX releases. The source has to be changed:

The old command \bf has to be changed to \textbf.

cd nihongo/katakana
wget https://ctan.org/tex-archive/macros/latex209/contrib/misc/multind.sty
sed -i -e 's%\\bf\s\+%\\textbf %g' multind.sty

ruby.sty

aptitude install latex-cjk-all

bclogo.sty (texlive-pstricks)

aptitude install texlive-extra-utils

Fonts

The font YoZ changed a lot since 2014. Therefore share/preamble/standard-english.tex was changed too.

aptitude install fonts-dejima-mincho fonts-yozvox-yozfont fonts-vlgothic\
fonts-takao-mincho fonts-motoya-l-maruberi fonts-kouzan-mouhitsu \
fonts-kiloji fonts-ipafont fonts-aoyagi-kouzan-t

Make sure 'non-free' is enabled in /etc/apt/sources.list for the Mikachan font.

aptitude install fonts-mikachan

nihongo-0.1.0

Dependencies

Operating System

nihongo-0.1.0 uses eps and pdf as pictures. This do not work well with newer versions of Debian. The last working version of Debian that is known to work is Debian 7 Wheezy.

LaTeX

nihongo-0.1.0 was tested with a full installation of texlive. Maybe a subset will work too.

aptitude install texlive-full

Fonts

For katakana 0.9 some additional fonts are needed.

aptitude install fonts-dejima-mincho fonts-yozvox-yozfont

Make sure 'non-free' is enabled in /etc/apt/sources.list for the Mikachan font.

aptitude install fonts-mikachan

Perl

The bin/extract-ifor script needs the Perl module Lingua::JA::Sort::JIS. Unfortunately there is no package for Debian 7 Wheezy. The module can be installed in many different ways. One method is to use cpanminus the other is to install it from source.

Installation From Source

wget https://cpan.metacpan.org/authors/id/S/SA/SADAHIRO/Lingua-JA-Sort-JIS-0.10.tar.gz
tar xvzf Lingua-JA-Sort-JIS-0.10.tar.gz
make
make test
make install # as root

Installation Via CPANminus

aptitude install cpanminus
cpanm Lingua/JA/Sort/JIS.pm