qiwulun / PanBook

Pandoc LaTeX,Epub模板,用于生成书籍,幻灯片(beamer),简历,论文等(cv, thesis, ebook,beamer)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status

简介

PanBook基于Pandoclua filter功能,适配各种书籍,论文,幻灯片及简历的LaTeXEPUB模板。 目标是使用Pandoc's Markdown作为写作语言,实现一次编写 多次生成

预览

Book Article Thesis Slide CV
ElegantBook ctexart Demo Thesis metropolis moderncv-classic
elegantnote 湖南大学(WIP) solarized resume
CTeXBook elegantpaper 清华大学(WIP) material TMR
CTeXBook-mobile 上海交通大学(WIP) Execushares moderncv-fancy
Epub 南京大学(WIP) classyslides moderncv-banking
山东大学(WIP) elegance moderncv-casual
**科学院大学(WIP) Hest moderncv-oldstyle
电子科技大学(WIP) opensuse
北京航空航天大学(WIP) Xiaoshan
more more more more

快速开始

Windows 10为例,演示如何使用。首先安装以下依赖软件

  • msys2( Linux 及 OS X 请忽略此步骤)
  • texlive 2018 或以上版本
  • Pandoc 2.9 或以上版本
  • pandoc-crossref 对应版本并安装到path目录下(建议和Pandoc放同一目录,即/c/Users/yourname/AppData/Local/Pandoc

然后下载本项目,打开msys2,假设工作目录为/d/dev

# 首先安装 git,msys2 包管理工具为 pacman
$ pacman -Ss git     # 查询软件包
$ pacman -S git      # 安装软件包
$ cd /d/dev
$ git clone https://github.com/annProg/PanBook

设置环境变量

需要将本项目,texlivePandoc加入环境变量,编辑~/.bashrc,加入以下内容

$ tail -n 1 ~/.bashrc
export PATH=$PATH:/d/texlive/2018/bin/win32:/d/dev/PanBook:/c/Users/myname/AppData/Local/Pandoc

开始使用

# 新建项目目录
$ mkdir /d/dev/mybook
$ cd /d/dev/mybook
# 生成示例 book 文档,编译结果在 build 目录
$ panbook book
# 查看帮助
$ panbook -h

然后编写 src 目录下的 Markdown 源文件。图片放在 src/images 下。

紧急情况

如果时间紧迫且 Panbook 生成失败时,可以在 build 文件夹下使用 xelatexlatexmk 手动编译,可考虑使用 -interaction=nonstopmode

升级指南

本包的主要升级内容在于 elegantbook.cls 等文件,

temp patch

texlive2020

报错信息: ! You can't use `\relax' after \the.

\usepackage{longtable,booktabs,tabu} % TODO: temp fix for tabu issue
%issue https://github.com/tabu-issues-for-future-maintainer/tabu/issues/24

贡献指南

欢迎提交IssuePull Requestextensions, styles开发流程请参考 PanBook 手册 第四章。

演示

使用本项目编译的书籍(欢迎加入此列表)

免责声明

请仔细阅读本软件 Licence

本软件不提供任何保证。在任何情况下,版权所有者或贡献者都不承担责任。

因此,当用于正式场合(比如学位论文)时,请您自行评估风险。

致谢

PanBook适配了一些开源LaTeX模板,列表如下:

Book Article Thesis Slide CV
ElegantBook ElegantNote moderncv
ElegantPaper more resume
tmr

About

Pandoc LaTeX,Epub模板,用于生成书籍,幻灯片(beamer),简历,论文等(cv, thesis, ebook,beamer)

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:TeX 53.2%Language:Smarty 25.4%Language:Lua 10.7%Language:Shell 8.3%Language:Makefile 1.3%Language:CSS 0.6%Language:Dockerfile 0.5%