拆分`bithesis.dtx`到`src/bithesis*.dtx` by YDX-2147483647 · Pull Request #707 · BITNP/BIThesis

YDX-2147483647 · 2026-01-06T09:51:37Z

同时将Makefile中的大部分.PHONY命令移至justfile，并删除了其它很少用的命令。

$ just
Available recipes:
    clean *ARGS           # Clean generated files and directories in the current directory
    list                  # List available recipes

    [build]
    cls                   # Build *.cls files
    copy                  # Copy necessary files to templates/*/ and relevant directories
    doc                   # Build bithesis.pdf
    handbooks             # Build handbooks

    [dev]
    check                 # Check LaTeX files with https://ctan.org/pkg/expltools
    regression-test *ARGS # Run regression tests (run with `--help` for help)
    test                  # Run compilation tests (mainly for CI, takes 3–6 minutes)

    [release]
    grad version dest="BIThesis-graduate-thesis-template" # 生成提供给研究生院的压缩包
    pkg                   # Build bithesis.zip for submission to CTAN (mainly for CI)
    undergrad version dest="BIThesis-undergraduate-thesis-templates" # 生成提供给教务部的压缩包

对最终使用者的影响

`*.cls`

生成的*.cls的只有开头的注释变了，实质性内容完全没有变化。

$ git diff --no-index ../BIThesis-backup/bitbeamer.cls src/bitbeamer.cls
diff --git "a/../BIThesis-backup/bitbeamer.cls" b/src/bitbeamer.cls
index f25cf03..efdb149 100644
--- "a/../BIThesis-backup/bitbeamer.cls"
+++ b/src/bitbeamer.cls
@@ -5,6 +5,8 @@
 %% The original source files were:
 %%
 %% bithesis.dtx  (with options: `cls,beamer')
+%% bithesis-beamer.dtx
+%% bithesis-finale.dtx
 %%
 %%     Copyright (C) 2025
 %%     Association of Bit Network Pioneer and any individual authors listed in the documentation.


$ git diff --no-index ../BIThesis-backup/bitreport.cls src/bitreport.cls
diff --git "a/../BIThesis-backup/bitreport.cls" b/src/bitreport.cls
index 6f3c785..44a08eb 100644
--- "a/../BIThesis-backup/bitreport.cls"
+++ b/src/bitreport.cls
@@ -5,6 +5,8 @@
 %% The original source files were:
 %%
 %% bithesis.dtx  (with options: `cls,report')
+%% bithesis-report.dtx
+%% bithesis-finale.dtx
 %%
 %%     Copyright (C) 2025
 %%     Association of Bit Network Pioneer and any individual authors listed in the documentation.


$ git diff --no-index ../BIThesis-backup/bithesis.cls src/bithesis.cls
diff --git "a/../BIThesis-backup/bithesis.cls" b/src/bithesis.cls
index e0248bb..95ef31b 100644
--- "a/../BIThesis-backup/bithesis.cls"
+++ b/src/bithesis.cls
@@ -5,6 +5,9 @@
 %% The original source files were:
 %%
 %% bithesis.dtx  (with options: `cls,thesis')
+%% bithesis-thesis.dtx
+%% bithesis-thesis-exports.dtx
+%% bithesis-finale.dtx
 %%
 %%     Copyright (C) 2025
 %%     Association of Bit Network Pioneer and any individual authors listed in the documentation.

`bithesis.pdf`

若直接编译，则完全无变化。

若显示「实现细节」（方法见DEVELOPMENT.md），那么_bithesis_会缩减为@@，如下图——这大约是受\DocInput/l3doc/DocStrip限制。

Copilot

Pull request overview

This PR reorganizes the project structure by moving core build files into a src/ directory and migrating from Makefile to justfile for build automation. The changes also include removing rarely-used development recipes and updating documentation references.

Moved core files (bithesis.dtx, bithesis.ins, etc.) to src/ directory
Replaced Makefile with justfile for build commands
Updated all documentation and script references from make to just

Reviewed changes

Copilot reviewed 11 out of 16 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/Makefile	New Makefile in src/ directory for building class files and documentation
scripts/test.py	Updated to use `just` commands and adjusted paths from SCAFFOLDDIR to TEMPLATE_DIR
scripts/regression_test.py	Updated docstring to reference `just` instead of `make`
justfile	New justfile replacing the old Makefile with simplified build recipes
bithesis.ins	Fixed typo: "Mainteiner" → "Maintainer"
bithesis-doc.tex	Updated image path from images/ to assets/
README-bithesis.md	Updated build command to `make -C src cls`
Makefile	Removed old Makefile (replaced by justfile)
DEVELOPMENT.md	Updated all documentation references from Makefile to justfile
.gitignore	Updated paths and comments to reflect new structure
.github/workflows/test.yaml	Updated CI to install just and use just commands
.github/workflows/release.yml	Updated release workflow to use just commands

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

.github/workflows/release.yml

Copilot

Pull request overview

Copilot reviewed 18 out of 22 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 18 out of 23 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

src/bithesis.ins:17

Corrected typo in comment: "Mainteiner" should be "Maintainer".

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 18 out of 23 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Also remove rarely-used recipes.

Relates-to: BITNP/BIThesis#707

YDX-2147483647 force-pushed the split branch 2 times, most recently from 0bd7c77 to 79c3ff9 Compare January 6, 2026 09:57

YDX-2147483647 requested a review from Copilot January 6, 2026 12:48

Copilot started reviewing on behalf of YDX-2147483647 January 6, 2026 12:49 View session

Copilot AI reviewed Jan 6, 2026

View reviewed changes

.github/workflows/release.yml Outdated Show resolved Hide resolved

YDX-2147483647 force-pushed the split branch from 79c3ff9 to 3de016c Compare January 6, 2026 14:31

YDX-2147483647 changed the title ~~chore: Move core files to src/ and create justfile~~ Split bithesis.dtx into src/bithesis*.dtx Jan 6, 2026

YDX-2147483647 changed the title ~~Split bithesis.dtx into src/bithesis*.dtx~~ Split bithesis.dtx to src/bithesis*.dtx Jan 6, 2026

YDX-2147483647 requested a review from Copilot January 6, 2026 16:17

YDX-2147483647 changed the title ~~Split bithesis.dtx to src/bithesis*.dtx~~ 拆分bithesis.dtx到src/bithesis*.dtx Jan 6, 2026

Copilot started reviewing on behalf of YDX-2147483647 January 6, 2026 16:17 View session

Copilot AI reviewed Jan 6, 2026

View reviewed changes

YDX-2147483647 force-pushed the split branch from c507759 to d8fbeaf Compare January 7, 2026 03:07

YDX-2147483647 requested a review from Copilot January 7, 2026 03:08

Copilot started reviewing on behalf of YDX-2147483647 January 7, 2026 03:08 View session

YDX-2147483647 force-pushed the split branch from d8fbeaf to 18558ca Compare January 7, 2026 03:09

Copilot AI reviewed Jan 7, 2026

View reviewed changes

YDX-2147483647 force-pushed the split branch 2 times, most recently from 83e32b8 to adc1ef8 Compare January 7, 2026 03:36

YDX-2147483647 marked this pull request as ready for review January 7, 2026 03:50

YDX-2147483647 requested a review from Copilot January 7, 2026 03:50

Copilot started reviewing on behalf of YDX-2147483647 January 7, 2026 03:51 View session

Copilot AI reviewed Jan 7, 2026

View reviewed changes

YDX-2147483647 force-pushed the split branch from adc1ef8 to a4dde70 Compare January 7, 2026 04:10

YDX-2147483647 added 4 commits January 7, 2026 12:13

chore: Move core files to src/ and create justfile

368ee1a

Also remove rarely-used recipes.

refactor: Split dtx files

aa76d0c

docs(dev): Update descriptions for DocStrip

37094c4

chore: Submit doc-src.zip to CTAN and organize cache dirs

f365713

YDX-2147483647 force-pushed the split branch from a4dde70 to f365713 Compare January 7, 2026 04:15

YDX-2147483647 added this pull request to the merge queue Jan 7, 2026

Merged via the queue into BITNP:main with commit 8e2d20b Jan 7, 2026
9 checks passed

YDX-2147483647 deleted the split branch January 7, 2026 04:17

YDX-2147483647 mentioned this pull request Jan 7, 2026

ci: Correct file paths and allow testing release.yml #708

Merged

YDX-2147483647 added a commit to BITNP/BIThesis-wiki that referenced this pull request Mar 11, 2026

docs(faq): bithesis.dtx已拆分为bithesis*.dtx

6ae3856

Relates-to: BITNP/BIThesis#707

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

拆分`bithesis.dtx`到`src/bithesis*.dtx`#707

拆分`bithesis.dtx`到`src/bithesis*.dtx`#707
YDX-2147483647 merged 4 commits intoBITNP:mainfrom
YDX-2147483647:split

YDX-2147483647 commented Jan 6, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

YDX-2147483647 commented Jan 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

对最终使用者的影响

*.cls

bithesis.pdf

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

YDX-2147483647 commented Jan 6, 2026 •

edited

Loading

`*.cls`

`bithesis.pdf`