Skip to content

Commit

Permalink
docs: remove some packages temporarily (#112)
Browse files Browse the repository at this point in the history
  • Loading branch information
LogCreative authored Jun 19, 2022
1 parent 8ff155b commit 8eed12b
Show file tree
Hide file tree
Showing 5 changed files with 95 additions and 98 deletions.
122 changes: 62 additions & 60 deletions contents/basis.tex
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ \subsection{\LaTeX{} 排版入门}
\item \pdfTeX{}:直接生成 PDF,支持 micro-typography
\item \XeTeX{}:支持 Unicode、OpenType 与复杂文字编排(CTL)
\item \LuaTeX{}:支持 Unicode,内联 Lua,支持 OpenType
\item (u)p\TeX{}:日本方面推动,生成 |.dvi|,(支持 Unicode)
\item (u)p\TeX{}:日本方面推动,生成 \verb|.dvi|,(支持 Unicode)
\item Ap\TeX{}:底层 CJK 支持,内联 Ruby,Color Emoji
\end{itemize}

Expand Down Expand Up @@ -53,17 +53,17 @@ \subsection{\LaTeX{} 排版入门}
\item 命令行

\begin{itemize}
\item |pdflatex|/|xelatex|/|lualatex| + |<文件名>[.tex]|
\item \verb|pdflatex|/\verb|xelatex|/\verb|lualatex| + \verb|<文件名>[.tex]|
\item 多次编译:每次均需要读取并处理中间文件
\item 推荐 \pkg{latexmk}\footnote{\MiKTeX 用户需要自行安装 perl 解释器}:运行 |latexmk [<选项>] <文件名>| 即可自动完成所有工作
\item 推荐 \pkg{latexmk}\footnote{\MiKTeX 用户需要自行安装 perl 解释器}:运行 \verb|latexmk [<选项>] <文件名>| 即可自动完成所有工作
\end{itemize}

\item 编辑器

\begin{itemize}
\item 按钮的背后仍然是命令
\item |PATH| 环境变量:确定可执行文件的位置
\item VS Code + \LaTeX{} Workshop:配置 |tools| 和 |recipes|
\item \verb|PATH| 环境变量:确定可执行文件的位置
\item VS Code + \LaTeX{} Workshop:配置 \verb|tools| 和 \verb|recipes|
\end{itemize}
\end{itemize}
\end{frame}
Expand Down Expand Up @@ -246,49 +246,51 @@ \subsection{\LaTeX{} 排版入门}
\end{itemize}
\end{frame}

\begin{frame}[fragile,label={frame:unicode-math}]{unicode-math:现代的数学输入方式}
\LaTeX{} 的公式确实很强大,但是……符号有点难记?

\pkg{unicode-math} 宏包提供了几乎所见即所得的公式输入:

\begin{itemize}
\item 可直接输入各类符号对应的 Unicode 字符(需要使用 UTF-8 编码):

\begin{columns}[c]
\begin{column}{0.45\textwidth}
\begin{lstlisting}
\begin{equation*}
∫ Γ(x) dx = ±∞
\end{equation*}
\end{lstlisting}
\end{column}\hspace{1em}
\begin{column}{0.45\textwidth}
\begin{equation*}
∫ Γ(x) dx = ±∞
\end{equation*}
\end{column}
\end{columns}
\item 使用 |symbf| 等命令自动处理字母的粗体、斜体等变体,不必引入额外宏包。
\end{itemize}

\begin{columns}[c]
\begin{column}{0.45\textwidth}
\begin{lstlisting}
\begin{align*}
\symbf{\beta} &= \beta \symbf{I} \\
\symbf{a} &= a \symbf{I}
\end{align*}
\end{lstlisting}
\end{column}\hspace{1em}
\begin{column}{0.45\textwidth}
\begin{align*}
\symbf{\beta} & = \beta \symbf{I} \\
\symbf{a} & = a \symbf{I}
\end{align*}
\end{column}
\end{columns}

\end{frame}
%% 需要在导言区使用 \usepackage{unicode-math}
%
% \begin{frame}[fragile,label={frame:unicode-math}]{unicode-math:现代的数学输入方式}
% \LaTeX{} 的公式确实很强大,但是……符号有点难记?

% \pkg{unicode-math} 宏包提供了几乎所见即所得的公式输入:

% \begin{itemize}
% \item 可直接输入各类符号对应的 Unicode 字符(需要使用 UTF-8 编码):

% \begin{columns}[c]
% \begin{column}{0.45\textwidth}
% \begin{lstlisting}
% \begin{equation*}
% ∫ Γ(x) dx = ±∞
% \end{equation*}
% \end{lstlisting}
% \end{column}\hspace{1em}
% \begin{column}{0.45\textwidth}
% \begin{equation*}
% ∫ Γ(x) dx = ±∞
% \end{equation*}
% \end{column}
% \end{columns}
% \item 使用 \verb|symbf| 等命令自动处理字母的粗体、斜体等变体,不必引入额外宏包。
% \end{itemize}

% \begin{columns}[c]
% \begin{column}{0.45\textwidth}
% \begin{lstlisting}
% \begin{align*}
% \symbf{\beta} &= \beta \symbf{I} \\
% \symbf{a} &= a \symbf{I}
% \end{align*}
% \end{lstlisting}
% \end{column}\hspace{1em}
% \begin{column}{0.45\textwidth}
% \begin{align*}
% \symbf{\beta} & = \beta \symbf{I} \\
% \symbf{a} & = a \symbf{I}
% \end{align*}
% \end{column}
% \end{columns}

% \end{frame}

\begin{frame}[fragile]{层次与目录生成}
\begin{columns}
Expand Down Expand Up @@ -363,9 +365,9 @@ \subsubsection{支持向量机的诞生}
\begin{frame}[fragile]{交叉引用与插入插图}
\begin{itemize}
\item 给对象命名:图片、表格、公式等\\
|\label{name}|
\verb|\label{name}|
\item 引用对象\\
|\ref{name}|
\verb|\ref{name}|
\end{itemize}
\bigskip

Expand Down Expand Up @@ -425,12 +427,12 @@ \subsubsection{支持向量机的诞生}
\begin{itemize}
\item 初学者最“捉摸不透”的特性之一 \link{https://liam.page/2017/03/11/floats-in-LaTeX-basic}
\item 图片和表格有时会很大,在插入的位置不一定放得下,因此需要浮动调整
\item 避免在文中使用「下图」「上图」的说法,而是使用图表的编号,例如 |图~\ref{fig:fig1}| 。
\item |\begin{figure}[<位置>] 图片 \end{figure}|
\item 避免在文中使用「下图」「上图」的说法,而是使用图表的编号,例如 \verb|图~\ref{fig:fig1}| 。
\item \verb|\begin{figure}[<位置>] 图片 \end{figure}|
\begin{itemize}
\item 位置参数指定浮动体摆放的偏好
\item |h| 当前位置(here), |t| 顶部(top), |b| 底部(bottom), |p| 单独成页(p)
\item |!h| 表示忽略一些限制,|H| 表示强制\alert{(强烈不建议,除非你知道自己在做什么)}
\item \verb|h| 当前位置(here), \verb|t| 顶部(top), \verb|b| 底部(bottom), \verb|p| 单独成页(p)
\item \verb|!h| 表示忽略一些限制,\verb|H| 表示强制\alert{(强烈不建议,除非你知道自己在做什么)}
\end{itemize}
\item 温馨提示:图标题一般在下方,表标题一般在上方
\end{itemize}
Expand Down Expand Up @@ -458,10 +460,10 @@ \subsubsection{支持向量机的诞生}
\item 插图格式

\begin{itemize}
\item 矢量图:|.pdf|
\item 位图:|.jpg| 或 |.png|
\item 矢量图:\verb|.pdf|
\item 位图:\verb|.jpg| 或 \verb|.png|
\item \alert{不再推荐 \texttt{.eps}}
\item 不(完全)支持 |.svg|、|.bmp|
\item 不(完全)支持 \verb|.svg|、\verb|.bmp|
\end{itemize}

\item 一些参考:\link{https://www.zhihu.com/question/21664179}
Expand Down Expand Up @@ -614,11 +616,11 @@ \subsection{论文模板使用}
\begin{itemize}
\item 获取模板:已随发行版自带
\begin{itemize}
\item 在安装目录 |<prefix>\texlive\2021\texmf-dist\doc\latex\IEEEtran|
下找到 |bare_jrnl.tex|
\item 在安装目录 \verb|<prefix>\texlive\2021\texmf-dist\doc\latex\IEEEtran|
下找到 \verb|bare_jrnl.tex|
\item 复制到某个文件夹(比如个人存论文的目录)
\end{itemize}
\item 编辑 |bare_jrnl.tex| 文件 (英文模板:不支持中文)
\item 编辑 \verb|bare_jrnl.tex| 文件 (英文模板:不支持中文)
\item 编译
\begin{itemize}
\item 英文文献:\XeLaTeX{}、\pdfLaTeX{} 编译均可
Expand Down
6 changes: 3 additions & 3 deletions contents/introduction.tex
Original file line number Diff line number Diff line change
Expand Up @@ -299,7 +299,7 @@ \subsection{安装}
\begin{itemize}
\item Windows
\begin{itemize}
\item 挂载或解压下载的 ISO,运行 |install-tl-windows.bat|
\item 挂载或解压下载的 ISO,运行 \verb|install-tl-windows.bat|
\item 切换默认仓库为国内镜像(如 SJTUG)可加速今后升级
\end{itemize}
\item macOS
Expand Down Expand Up @@ -379,9 +379,9 @@ \subsection{安装}
\end{itemize}
\item \TL
\begin{itemize}
\item 设置仓库地址 |tlmgr option repository| {\footnotesize\ttfamily
\item 设置仓库地址 \verb|tlmgr option repository| {\footnotesize\ttfamily
https://mirrors.sjtug.sjtu.edu.cn/CTAN/systems/texlive/tlnet}
\item |tlmgr install <pkgname>| 安装、 |tlmgr update --self --all| 全部更新
\item \verb|tlmgr install <pkgname>| 安装、 \verb|tlmgr update --self --all| 全部更新
\item \faWindows{} 开始菜单里找 TeX Live Manager
\end{itemize}
\item \MiKTeX
Expand Down
14 changes: 7 additions & 7 deletions contents/summary.tex
Original file line number Diff line number Diff line change
Expand Up @@ -69,9 +69,9 @@ \section{总结}
\end{itemize}
\item 工具
\begin{itemize}
\item |tlmgr|: \TL 管理器
\item |texdoc|: \TeX{} 文档查看器\\
例如:|texdoc lshort-zh-cn|
\item \verb|tlmgr|: \TL 管理器
\item \verb|texdoc|: \TeX{} 文档查看器\\
例如:\verb|texdoc lshort-zh-cn|
\item 在线文档 \TeX{}doc \link{http://texdoc.net/}
\item TeX Studio 和 WinEdt 都支持在帮助里看文档
\end{itemize}
Expand Down Expand Up @@ -106,10 +106,10 @@ \section{总结}
\end{itemize}
\item 基本用法
\begin{itemize}
\item 跟踪更改:|git init|、|git add|、|git commit|
\item 撤销与回滚:|git reset|、|git revert|
\item 分支与高级用法:|git branch|、|git checkout|、|git rebase|
\item 远端仓库操作:|git pull|、|git push|、|git fetch|
\item 跟踪更改:\verb|git init|、\verb|git add|、\verb|git commit|
\item 撤销与回滚:\verb|git reset|、\verb|git revert|
\item 分支与高级用法:\verb|git branch|、\verb|git checkout|、\verb|git rebase|
\item 远端仓库操作:\verb|git pull|、\verb|git push|、\verb|git fetch|
\item 推荐用 VS Code 等进行可视化操作
\item 参考链接:\link{https://git-scm.com/book/en/v2}
\link{https://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000}
Expand Down
44 changes: 23 additions & 21 deletions contents/thesis.tex
Original file line number Diff line number Diff line change
Expand Up @@ -44,16 +44,16 @@ \subsection{\SJTUThesis 上海交通大学学位论文模板}
\item 下载最新开发版(高级 / 想尝鲜 / 着急的用户)
\begin{itemize}
\item \url{https://github.com/sjtug/SJTUThesis}
\item 切换到 |develop| 分支,点右边栏
\item 切换到 \verb|develop| 分支,点右边栏
\href{https://github.com/sjtug/SJTUThesis/archive/dev.zip}%
{Download ZIP} 按钮
\end{itemize}
\item 编译
\begin{itemize}
\item 解压缩看文档 |README.md|
\item Windows: 双击 |Compile.bat| 脚本编译
\item Linux \& macOS: 使用 |Makefile|
\item 使用 |latexmk -xelatex main|
\item 解压缩看文档 \verb|README.md|
\item Windows: 双击 \verb|Compile.bat| 脚本编译
\item Linux \& macOS: 使用 \verb|Makefile|
\item 使用 \verb|latexmk -xelatex main|
\end{itemize}
\end{itemize}
\end{column}
Expand All @@ -77,15 +77,15 @@ \subsection{\SJTUThesis 上海交通大学学位论文模板}
\begin{lstlisting}[basicstyle=\ttfamily]
\documentclass[type=master,review]{sjtuthesis}
\end{lstlisting}
\item[fontset] 指定字体(推荐使用 |windows|)
\item[fontset] 指定字体(推荐使用 \verb|windows|)
\begin{lstlisting}[basicstyle=\ttfamily]
\documentclass[type=doctor,fontset=windows]{sjtuthesis}
\end{lstlisting}
\end{description}
\end{frame}

\begin{frame}[fragile]{模板设置}
使用 |\sjtusetup| 命令指定论文各类设置:
使用 \verb|\sjtusetup| 命令指定论文各类设置:
\begin{lstlisting}
\sjtusetup{
info = {
Expand All @@ -105,20 +105,20 @@ \subsection{\SJTUThesis 上海交通大学学位论文模板}
\end{frame}

\begin{frame}[fragile]{信息录入}
|info| 域完成论文基本信息录入
\verb|info| 域完成论文基本信息录入
\begin{table}[h]
\centering
\footnotesize
\begin{tabular}{lll} \toprule
命令作用 & 中文对应选项 & 英文对应选项 \\ \midrule
论文标题 & |title| & |title*| \\
关键字列表 & |keywords| & |keywords*| \\
作者姓名 & |author| & |author*| \\
申请学位名称 & |degree| & |degree*| \\
院系名称 & |department| & |department*| \\
专业名称 & |major| & |major*| \\
导师 & |supervisor| & |supervisor*| \\
副导师 & |assisupervisor| & |assisupervisor*| \\
论文标题 & \verb|title| & \verb|title*| \\
关键字列表 & \verb|keywords| & \verb|keywords*| \\
作者姓名 & \verb|author| & \verb|author*| \\
申请学位名称 & \verb|degree| & \verb|degree*| \\
院系名称 & \verb|department| & \verb|department*| \\
专业名称 & \verb|major| & \verb|major*| \\
导师 & \verb|supervisor| & \verb|supervisor*| \\
副导师 & \verb|assisupervisor| & \verb|assisupervisor*| \\
日期 & \multicolumn{2}{c}{\texttt{date}} \\
学号 & \multicolumn{2}{c}{\texttt{id}} \\ \bottomrule
\end{tabular}
Expand All @@ -128,7 +128,7 @@ \subsection{\SJTUThesis 上海交通大学学位论文模板}
\begin{frame}[fragile]{数学}
\begin{itemize}
\item 公式示例:\nolinkurl{contents/math_and_citations.tex}
\item \SJTUThesis{} 定义了常用的数学环境(需要手工引入 |amsthm| 宏包):
\item \SJTUThesis{} 定义了常用的数学环境(需要手工引入 \verb|amsthm| 宏包):
\begin{table}[h]
\centering
\footnotesize
Expand All @@ -154,7 +154,7 @@ \subsection{\SJTUThesis 上海交通大学学位论文模板}
\item 控制文献、引用样式:\pkg{natbib} 宏包
\item 国标样式:\pkg{gbt7714} 宏包 \link{https://mirrors.sjtug.sjtu.edu.cn/ctan/biblio/bibtex/contrib/gbt7714/gbt7714.pdf}
\end{itemize}
\item 现代方法:|biber| 后端 + \pkg{biblatex} 宏包
\item 现代方法:\verb|biber| 后端 + \pkg{biblatex} 宏包
\begin{itemize}
\item 国标样式:\pkg{biblatex-gbt7714-2015} 宏包 \link{https://mirrors.sjtug.sjtu.edu.cn/ctan/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.pdf}
\end{itemize}
Expand All @@ -164,7 +164,7 @@ \subsection{\SJTUThesis 上海交通大学学位论文模板}

\begin{frame}[fragile]{参考文献(续)}
\begin{itemize}
\item 生成 |.bib| 数据库
\item 生成 \verb|.bib| 数据库
\begin{itemize}
\item Google Scholar 可直接复制或者批量导出
\item 用 Zotero、Jabref 等文献管理软件生成
Expand All @@ -188,13 +188,15 @@ \subsection{\SJTUThesis 上海交通大学学位论文模板}
\item 常见问题
\begin{itemize}
\item 参考文献列表出错、缺少字体、无法编译、格式不对……
\item 阅读模板文档 |sjtuthesis.pdf| 和 SJTUThesis 示例文档代码
\item 查看 FAQ \link{https://github.com/sjtug/SJTUThesis/wiki/常见问题}
\item 阅读模板文档 \verb|sjtuthesis.pdf| 和 SJTUThesis 示例文档代码
\item 查看 Wiki \link{https://github.com/sjtug/SJTUThesis/wiki}
\end{itemize}

\item 主动提问
\begin{itemize}
\item GitHub Discussions 提问:\link{https://github.com/sjtug/SJTUThesis/discussions}
\item GitHub Issues 报告 BUG:\link{https://github.com/sjtug/SJTUThesis/issues}
\end{itemize}

\end{itemize}
\end{frame}
7 changes: 0 additions & 7 deletions main.tex
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,6 @@
\usepackage{amsmath}
\usepackage{mflogo}
\usepackage{graphicx}
\usepackage{unicode-math}
\usepackage{ccicons}
\usepackage{hologo}
\usepackage{colortbl}
Expand Down Expand Up @@ -98,12 +97,6 @@
breaklines=true,
}

\lstdefinestyle{style@inline}{
basicstyle = \ttfamily,
keepspaces = true
}
\lstMakeShortInline[style=style@inline]|

\usetheme[maxplus]{sjtubeamer}
% 使用 maxplus/max/min 切换标题页样式
% 使用 red/blue 切换主色调
Expand Down

0 comments on commit 8eed12b

Please sign in to comment.