Skip to content

Commit

Permalink
v1.7
Browse files Browse the repository at this point in the history
  • Loading branch information
mathedu4all committed Aug 10, 2022
1 parent e111742 commit 13b22b8
Show file tree
Hide file tree
Showing 22 changed files with 1,736 additions and 380 deletions.
4 changes: 3 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
fonts
Makefile
.vscode
.vscode
install.sh
dist
26 changes: 11 additions & 15 deletions BHCexam.cls
Original file line number Diff line number Diff line change
@@ -1,9 +1,11 @@
% BHCexam.cls
%
% A LaTeX2e document class for preparing exams.
% An exam class designed for mathematics teacher in China.
% Since 2016, it was used by mathcrowd.cn ( an opensource math exam database) as the default class to export exam papers.
%

%% BHCexam.cls
%% Copyright (c) 2011-2020 BAO HONG CHANG
%% Copyright (c) 2011-2022 BAO HONG CHANG
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
Expand All @@ -15,9 +17,10 @@
%
% This work has the LPPL maintenance status "author-maintained".
%
% This work consists of the files BHCexam.cls and BHCexamdoc.tex.
% This work consists of the files BHCexam.cls.
% Documation on https://docs.mathcrowd.cn/advances/bhcexam.html
% Support on https://github.com/mathedu4all/bhcexam/issues
%
% The user's guide for exam.cls is in the file examdoc.tex.

%%% BAO HONG CHANG
%%% Mathcrowd Inc.
Expand All @@ -27,8 +30,8 @@
% The newest version of this documentclass should always be available
% from my web page: https://github.com/mathedu4all/bhcexam

\def\fileversion{1.6}
\def\filedate{2021/08/30}
\def\fileversion{1.7}
\def\filedate{2022/07/29}

\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{BHCexam}[\filedate\space Version \fileversion\space by
Expand All @@ -47,25 +50,18 @@
% windows 使用windows字体
% fandol 使用fandol字体,随texlive默认安装
% mac 使用mac字体
% csize5 默认字体大小为五号
% csize4 默认字体大小为小四
% list 以列表项目格式显示试题
% twocolumn 使用A3纸张并分栏


\newif\if@printanswers \@printanswersfalse
\DeclareOption{answers}{\@printanswerstrue}

\newcommand\@fontsize{false}
\DeclareOption{csize5}{\renewcommand\@fontsize{5}}
\DeclareOption{csize4}{\renewcommand\@fontsize{-4}}


\newcommand\@fontset{windows}
\DeclareOption{adobe}{\renewcommand\@fontset{adobe}}
\DeclareOption{ubuntu}{\renewcommand\@fontset{ubuntu}}
\DeclareOption{mac}{\renewcommand\@fontset{mac}}
\DeclareOption{windows}{\renewcommand\@fontset{windowsnew}}
\DeclareOption{windows}{\renewcommand\@fontset{windows}}
\DeclareOption{fandol}{\renewcommand\@fontset{fandol}}

\newif\if@twocolumn \@twocolumnfalse
Expand All @@ -79,7 +75,7 @@
\ProcessOptions\relax
\LoadClass{article}

\RequirePackage[fontset = \@fontset, zihao = \@fontsize, punct=kaiming]{ctex}
\RequirePackage[fontset = \@fontset, punct=kaiming]{ctex}
\ctexset{linestretch = 4, autoindent = 0pt}


Expand Down
52 changes: 52 additions & 0 deletions README-zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# BHCexam

[English](./README.md)

BHCexam 是一款为中国数学老师设计的试卷排版文档类,目前已被 [橘子数学开源题库社区](https://www.mathcrowd.cn) 选用为默认文档类导出试卷pdf文件.

你可以使用该文档类实现:

* 将内容与样式分离
* 使用一个参数生成教师版和学生版试卷;
* 排版3-6个选项的选择题,可根据选项的长度自适应对齐;
* 排版填空题,可根据答案的长度自适应设置横线长度;
* 排版简答题,并以列表形式展示小问,并控制是否展示小问、缩进;
* 对试题分组,对组内试题以列表呈现,并控制是否展示分值、留空、是否重新开始编号;
* 更多 (见 [BHCexam 文档](http://docs.mathcrowd.cn/advances/bhcexam.html) )

## 版本历史

* **version 1.7** (2022.8)
* 针对TeXLive 2022, 修正`ctex`的字号、字体设置.
* **version 1.6** (2021.8)
* 不再使用`stix`数学字体
* `ctex` 设置 `punct = kaiming`
* **version 1.5** (2020.6)
* `questions` 环境新增 `r` 选项,重置题组的编号;
*`master` 分支中清理历史版本;
* 新增 `fandol` 宏包选项以支持 `fandol` 字体;
* **version 1.4** (2020.5)
* 支持`subquestion`环境的嵌套;
* `\parallel` 命令重定义;
* **version 1.3** (2020.3)
* 新增 `\sixchoices` , `\threechoices` 命令,以支持对3个和6个选项,并保持智能断行同及选项对齐.
* **version 1.2** (2020.3)
* 支持苹果字体
* 使用 `stix` 数学字体
* 支持在选择题最后显示右对齐括号
* **version 1.1** (2020.1)
* 新增对A3双栏版式的支持
* 新增列表样式的试题
* **version 1.0** (2019.5)
* 弃用 `exam` 而改用 `article` 为基宏包类

## 贡献者

* Bao Hongchang - @mathedu4all, charles@mathcrowd.cn
* CamuseCao - @ CamuseCao, camusecao@gmail.com

------

This work may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3 of this license
or (at your option) any later version.
63 changes: 14 additions & 49 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,63 +1,28 @@
# BHCexam

> 一个让Latex初学者快速上手的试卷排版文档类.
[中文版](./README-zh.md)

## 特别说明
BHCexam is an exam class designed for mathematics teacher in China.

BHCexam 自 0.5 版本起,针对 [橘子数学开源题库社区](https://www.mathcrowd.cn) 的组卷导出功能而定制开发.
Now it is used by [mathcrowd.cn](www.mathcrowd.cn) ( an opensource math exam database) as the default class to export exam papers in pdf.

## 文档
Using bhcexam you can

BHCexam的相关帮助文档:

* [BHCexam文档](http://docs.mathcrowd.cn/advances/bhcexam.html)
* [如何编译橘子数学的 .tex 文件](http://docs.mathcrowd.cn/howtos/how_to_compile_mathcrowd_tex.html)
* [如何将Word/PDF文件中的内容转为$\LaTeX$](http://docs.mathcrowd.cn/howtos/how_to_import_from_word.html)

## 版本历史

* **version 1.6** (2021.8)
* 不再使用`stix`数学字体
* `ctex` 设置 `punct = kaiming`
* **version 1.5** (2020.6)
* `questions` 环境新增 `r` 选项,重置题组的编号;
*`master` 分支中清理历史版本;
* 新增 `fandol` 宏包选项以支持 `fandol` 字体;
* **version 1.4** (2020.5)
* 支持`subquestion`环境的嵌套;
* `\parallel` 命令重定义;
* **version 1.3** (2020.3)
* 新增 `\sixchoices` , `\threechoices` 命令,以支持对3个和6个选项,并保持智能断行同及选项对齐.
* **version 1.2** (2020.3)
* 支持苹果字体
* 使用 `stix` 数学字体
* 支持在选择题最后显示右对齐括号
* **version 1.1** (2020.1)
* 新增对A3双栏版式的支持
* 新增列表样式的试题
* **version 1.0** (2019.5)
* 弃用 `exam` 而改用 `article` 为基宏包类

## Contributors

* Bao Hongchang - @mathedu4all, charles@mathcrowd.cn
* CamuseCao - @ CamuseCao, camusecao@gmail.com

## 社区其他项目

* [mathcrowd-css](https://github.com/mathedu4all/mathcrowd-css)

该项目实现了将橘子数学开源题库中的试题一键导出到微信公众号,其中包含了一个测试环境和所有导出样式的CSS.

* [mathcrowd-docs](https://github.com/mathedu4all/mathcrowd-docs)

橘子数学社区文档.
* separate the format and the content very well;
* export both teacher paper and student paper;
* typeset multiple choice questions with 3-6 options keeping adaptively neat alignment;
* typeset cloze questions with an adaptively underline;
* typeset questions with subquestions in list;
* group questions  in list to control whether to show score, leave spacing, initialize question number;
* and more (see [BHCexam Documentation](http://docs.mathcrowd.cn/advances/bhcexam.html)).

## Authors and Contributors

* Bao Hongchang <charles@mathcrowd.cn>
* CamuseCao <camusecao@gmail.com>

------

This work may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3 of this license
or (at your option) any later version.

1 change: 0 additions & 1 deletion examples/BHCexam.cls

This file was deleted.

Loading

0 comments on commit 13b22b8

Please sign in to comment.