Slide 1
Slide 1 text
SphinxͱLaTeXͰ࡞
ΔӳจϚχϡΞϧ
Kenji Rikitake / SphinxConJP 2014 1
Slide 2
Slide 2 text
ྗ ݈࣍ ʢΓ͖͚ͨ ͚Μ͡ʣ
ྗ݈ٕ࣍ज़࢜ࣄॴॴ
@jj1bdx
http://rikitake.jp/
SphinxCon JP 2014
26-OCT-2014
Shibuya-ku, Tokyo, Japan
Kenji Rikitake / SphinxConJP 2014 2
Slide 3
Slide 3 text
ࣗݾհ
—Sphinxར༻ྺ:
—LaTeXར༻ྺ: 21
—1994ʹLaTeXͰຊ
ޠͷຊΛॻ͖·ͨ͠
—2004ʹLaTeXͰӳޠ
ͷത࢜จΛॻ͖·ͨ͠
—Sphinxॳ৺ऀͰ͢
Kenji Rikitake / SphinxConJP 2014 3
Slide 4
Slide 4 text
LaTeXʢϥςοΫʣͬͯԿ?
—൛γεςϜTeXͷ্ͷϚʔΫΞοϓݴޠ
—30ͷྺ࢙ʢຊޠԽ΄΅ಉ͡ʣ
—จϨϙʔτʹඞਢ
—ઐॻΛத৺ʹຊͷग़൛࣮ଟ
—ӳจʢจʣͷ൛Wordͱൺֱʹ
ͳΒͳ͍͘Β͍ඒ੍͔ͭ͘͠ޚ͍͢͠
—ࣗ༝ͳϥΠηϯεͰར༻Ͱ͖Δ
Kenji Rikitake / SphinxConJP 2014 4
Slide 5
Slide 5 text
LaTeXͷจষͷྫ
%%% Source code quoted from:
%%% Rikitake, K., Suzuki, T., and Nakao, K.:
%%% DNS Security: Now and The Future,
%%% IEICE Technical Report ISEC2007-1, pp. 3-8 (2007).
\begin{itemize}
\item deletion of the NS RRs by the expiration of DNS registry
subscription~\footnote{On May 2005, \url|e-ontap.com|, which had the
authoritative servers running for \url|visa.co.jp| and other related
domains, was found non-existent. Suzuki~\cite{tss-visa} took over the
control of \url|e-ontap.com| to prevent further possible domain
abuse and hijacking.};
\item NS RRs are not directed to the appropriate servers; and
\item A/AAAA RRs do not point the correct IP addresses of the
servers listed in the NS RRs.
\end{itemize}
Kenji Rikitake / SphinxConJP 2014 5
Slide 6
Slide 6 text
LaTeXͷ൛ͷྫ(1/2)
ຊจ
Kenji Rikitake / SphinxConJP 2014 6
Slide 7
Slide 7 text
LaTeXͷ൛ͷྫ(2/2)
٭
Kenji Rikitake / SphinxConJP 2014 7
Slide 8
Slide 8 text
Sphinx͔ΒLaTeXΛ͏ར
—ReSTͰେ෦͕౷ҰͰ͖Δ
—HTMLͱPDFΛಉ͡ιʔε͔Β࡞ΕΔ
—ιʔεͷຒΊࠐΈָ͕ (code-block)
—URLͷຒΊࠐΈָ͕ ʢࣗಈมʣ
—ਤͷຒΊࠐΈָ (image)
—LaTeX͍ͷਓʹσόοάָ͕(?)
Kenji Rikitake / SphinxConJP 2014 8
Slide 9
Slide 9 text
SphinxͰͲΜͳϚχϡΞϧΛॻ͍͔ͨ
—גࣜձࣾηΩϡΞεΧΠɾςΫϊϩδʔ
༷ͷґཔʹΑΔಉࣾͷຊޠจॻ͔Βӳ
ޠจॻͷ༁
—HTML൛จॻ࡞͕࠷༏ઌɼPDF2൪
—JavaɼPHPɼͦͷଞιʔείʔυଟ
—ଟͷਤ൛(100ຕ)
—༰ඇެ։ͷͨΊׂѪ
Kenji Rikitake / SphinxConJP 2014 9
Slide 10
Slide 10 text
ϚχϡΞϧͷαϯϓϧ
—…ͱ͍͑ɼαϯϓϧ͕ͳ͍ͱ͕͢͞ʹ
આ໌͍͠ͷͰ࡞Γ·ͨ͠
—https://github.com/jj1bdx/
sphinxconjp2014-examples/
Kenji Rikitake / SphinxConJP 2014 10
Slide 11
Slide 11 text
SphinxΛָͬͯʹͳΒͳ͍͜ͱ
—༁ͷۤ࿑ಉ͡
—ਤ൛Λ࡞Δۤ࿑ಉ͡
—ߍਖ਼ͷۤ࿑ಉ͡
—ཁ͢Δʹ࣭Λ্͛Δۤ࿑ಉ͡
—େࣄͳͷ্هͷ࡞ۀʹΑΓଟ͘ͷ࣌ؒ
ΛׂΓͯΔ͜ͱͰɼͦͷͨΊʹSphinx
LaTeXΛ͏
Kenji Rikitake / SphinxConJP 2014 11
Slide 12
Slide 12 text
ؔ࿈ΩοτͷΠϯετʔϧ
—TeXLive 2014 (MacͳΒMacTeX)Λ͏
—LaTeXͦͷͷຊޠରԠࡁΈ
—ຊޠͷࡉ͔͍tipsԞଜઌੜͷTeX
Wiki ʹ http://oku.edu.mie-u.ac.jp/
~okumura/texwiki/
—pLaTeX͕ಈ͚·ͣ४උྃ
Kenji Rikitake / SphinxConJP 2014 12
Slide 13
Slide 13 text
LaTeXͷࢀߟॻ
—Ԟଜஶʦվగୈ6
൛ʧLaTeX2e ඒจॻ࡞
ೖʢٕज़ධࣾʣ
—http://gihyo.jp/book/
2013/978-4-7741-6045-
0
—ஶऀʹΑΔՃใ:
http://oku.edu.mie-
u.ac.jp/~okumura/
bibun6/
Kenji Rikitake / SphinxConJP 2014 13
Slide 14
Slide 14 text
LaTeXܦ༝ͷPDFੜ
—make latexpdfja Ͱ _build/latex/
ͷԼʹҰࣜͰ͖Δ(Sphinx 1.2.3)ͷͰɼͦ
͜Ͱ͞Βʹmake͢ΔͱPDF͕Ͱ͖Δ
—ਤextractbbͰαΠζใΛऔಘͯ͠
͓͘ʢGNU parallelͰߴԽͰ͖Δʣ
parallel extractbb ::: *.jpg *.png
Kenji Rikitake / SphinxConJP 2014 14
Slide 15
Slide 15 text
HTML༻index.rstͷઃఆ
.. toctree::
license
.. toctree::
:maxdepth: 4
:numbered: 3
chapter1
chapter2
Kenji Rikitake / SphinxConJP 2014 15
Slide 16
Slide 16 text
LaTeX༻index.rstͷઃఆ(1/2)
.. raw:: latex
%%%
%%% Disable all chapter/section numbering
\setcounter{secnumdepth}{-2}
%%%
.. toctree::
license
Kenji Rikitake / SphinxConJP 2014 16
Slide 17
Slide 17 text
LaTeX༻index.rstઃఆ(2/2)
.. raw:: latex
%%%
%%% Max toctree level: 1.2.3
\setcounter{secnumdepth}{2}
%%% Reset all counters
\setcounter{chapter}{0}
\setcounter{section}{0}
\setcounter{subsection}{0}
%%%
.. toctree::
chapter1
chapter2
Kenji Rikitake / SphinxConJP 2014 17
Slide 18
Slide 18 text
LaTeX༻conf.pyͷઃఆ(1/3)
latex_elements = {
# The paper size ('letterpaper' or 'a4paper').
'papersize': 'a4paper',
# The font size ('10pt', '11pt' or '12pt').
'pointsize': '10pt',
# Additional stuff for the LaTeX preamble.
'classoptions': ',dvipdfmx',
'babel': r'\usepackage[english]{babel}',
'fncychap': '',
'fontpkg': r'\usepackage{amsmath,txfonts}',
Kenji Rikitake / SphinxConJP 2014 18
Slide 19
Slide 19 text
LaTeX༻conf.pyͷઃఆ(2/3)
# latex_elementsͷఆ͕ٛଓ͘
'preamble': r'''
\hypersetup{colorlinks=false}
\setcounter{tocdepth}{3}
%%% see sphinxmanual.cls
\makeatletter % needs this to enable @-mark
% aligned: 7.6em, 0em: no indent for
% multiple index lines
\renewcommand*\l@subsubsection{%
\@dottedtocline{3}{11.1em}{0em}}
\renewcommand{\@pnumwidth}{2em}
\renewcommand{\@dotsep}{1.5}
\makeatother % needs this to disable @-mark
''',
}
Kenji Rikitake / SphinxConJP 2014 19
Slide 20
Slide 20 text
LaTeX༻conf.pyͷઃఆ(3/3)
latex_documents = [
('index-latex',
'LaTeXtestdocforSphinxConJP2014.tex',
u'LaTeX test doc for SphinxConJP 2014 Documentation',
u'Kenji Rikitake', 'manual'),
]
Kenji Rikitake / SphinxConJP 2014 20
Slide 21
Slide 21 text
Sphinxͷઃఆ͔ΒLaTeXιʔεͷө
ө͞ΕΔॴʹҙ͕ඞཁ
%%% conf.pyͷpreamble͜͜
\begin{document}
...
\maketitle
\tableofcontents
%%% licenseͷલʹॻ͍ͨrawͷ༰
% license.rstͷத
%%% chapter1,2ͷલʹॻ͍ͨrawͷ༰
% chapter*.rstͷத͕ଓ͘
\end{document}
Kenji Rikitake / SphinxConJP 2014 21
Slide 22
Slide 22 text
SphinxͷLaTeXॲཧͰݟΔ͖ॴ
—texinputs/sphinxmanual.cls
—writers/latex.py
—ಛʹ default_elements
—ઃఆͷ্ॻ͖conf.pyͷpreambleͰ
—@͕ೖΔͱ͖\makeatletterͱ
\makeatotherͰ͘͘Δ
Kenji Rikitake / SphinxConJP 2014 22
Slide 23
Slide 23 text
੍ݶࣄ߲: ෳߦ/ྻηϧͷදදࣔෆՄ
—Sphinx 1.2.2ͰLaTeXίϯύΠϧΤϥʔ
—μϝͳྫ
+--------------------+----------------+
| 2 rows and 2 cols | 1 row x 3 cols |
| +----+-----+-----+
| | A | B | C |
+---+----------------+----+-----+-----+
| 1 | 2 | 3 | 4 | 5 |
+---+----------------+----+-----+-----+
Kenji Rikitake / SphinxConJP 2014 23
Slide 24
Slide 24 text
ͦͷଞLaTeXιʔεੜͰͷҙࣄ߲
—ਤදͷԣ෯ϖʔδຊจͷ෯͍ͬͺ͍ʹ
ల։͞ΕΔʢ2ஈͷϚΫϩͰճආ?ʣ
—ग़དྷ্͕ΓΧϥʔʢനࠇઃఆՄʣ
—্ΓLaTeXϚΫϩ/ελΠϧϑΝΠϧ
࣍ୈˠ࡞ΓࠐΈΛ͍ͨ͠ͱ͖࠷ॳ͔Β
શ෦ࣗલͰ༻ҙ͢Δඞཁ͕͋Δ
—·ͣॳظઃఆͰ͍मਖ਼͢Δͷ͕ૣಓ
Kenji Rikitake / SphinxConJP 2014 24
Slide 25
Slide 25 text
݁: ཁΛ͏Ұ
—Sphinx͔ΒPDFΛ࡞ΔʹLaTeXͷษڧ
Λ͓ͯ͘͠ͱԠ༻͕ޮ͘
—ΠϯετʔϧʹTeXLiveΛ͍·͠ΐ͏
—HTMLͱLaTeXͰϚελʔυΩϡϝϯ
τผʹ࡞͓ͬͯ͘
—LaTeXੜͷৄࡉΛΔʹPython͕ಡ
ΊΔΑ͏ʹͳ͓ͬͯ͘ͱΑ͍
Kenji Rikitake / SphinxConJP 2014 25
Slide 26
Slide 26 text
αϯϓϧͪ͜ΒͰ͢
—https://github.com/jj1bdx/
sphinxconjp2014-examples/
Kenji Rikitake / SphinxConJP 2014 26