-
Notifications
You must be signed in to change notification settings - Fork 1.2k
scut-social-practice-form:0.1.0 #5369
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| MIT License | ||
|
|
||
| Copyright (c) 2026 scut-social-practice-form contributors | ||
|
|
||
| Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| of this software and associated documentation files (the "Software"), to deal | ||
| in the Software without restriction, including without limitation the rights | ||
| to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
| copies of the Software, and to permit persons to whom the Software is | ||
| furnished to do so, subject to the following conditions: | ||
|
|
||
| The above copyright notice and this permission notice shall be included in all | ||
| copies or substantial portions of the Software. | ||
|
|
||
| THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
| AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
| SOFTWARE. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,33 @@ | ||
| # SCUT Social Practice Form | ||
|
|
||
| A Typst template for student social-practice registration forms. | ||
|
|
||
| ## Use as a template | ||
|
|
||
| Choose this package in the Typst Universe template gallery, then fill in the | ||
| values in `template/main.typ`. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. When used this way, the file will be at the root of the project, not in the |
||
|
|
||
| ## Use as a package | ||
|
|
||
| Once this package has been accepted into Typst Universe, import it with: | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. You can assume the package is accepted, since people will not really be able to see that README otherwise. |
||
|
|
||
| ```typst | ||
| #import "@preview/scut-social-practice-form:0.1.0": social-practice-form | ||
|
|
||
| #social-practice-form( | ||
| name: [张三], | ||
| political-status: [共青团员], | ||
| hometown: [广东省广州市], | ||
| college: [软件学院], | ||
| major: [软件工程], | ||
| grade: [2024 级], | ||
| practice-unit: [华南理工大学], | ||
| ) | ||
| ``` | ||
|
|
||
| All content parameters are optional. Pass content in square brackets, which | ||
| also supports multiple paragraphs for long-form fields. | ||
|
|
||
| ## License | ||
|
|
||
| MIT. | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,118 @@ | ||
| // 社会实践登记表模板 | ||
| // | ||
| // 使用方法:在自己的 Typst 文件中导入并调用本模板。 | ||
| // | ||
| // #import "@preview/scut-social-practice-form:0.1.0": social-practice-form | ||
| // #social-practice-form( | ||
| // name: [张三], | ||
| // political-status: [共青团员], | ||
| // hometown: [广东省广州市], | ||
| // college: [软件学院], | ||
| // major: [软件工程], | ||
| // grade: [2024 级], | ||
| // practice-unit: [华南理工大学], | ||
| // practice-summary: [在此输入个人实践小结,可分段撰写。], | ||
| // practice-unit-assessment: [在此输入实践单位评议。], | ||
| // college-opinion: [在此输入学院意见。], | ||
| // school-opinion: [在此输入学校意见。], | ||
| // show-original-page-numbers: false, | ||
| // ) | ||
| // | ||
| // 未传入的字段保持为空。长文本可直接使用 Typst 内容块编写多段文字。 | ||
|
|
||
| // Public template function. Each parameter accepts Typst content, e.g. [张三]. | ||
| #let social-practice-form( | ||
| name: none, | ||
| political-status: none, | ||
| hometown: none, | ||
| college: none, | ||
| major: none, | ||
| grade: none, | ||
| practice-unit: none, | ||
| practice-summary: none, | ||
| practice-unit-assessment: none, | ||
| college-opinion: none, | ||
| school-opinion: none, | ||
| show-original-page-numbers: true, | ||
| title: "学生社会实践登记表", | ||
| ) = { | ||
| // Keep the original form's A4 geometry and typography. | ||
| set page(width: 210mm, height: 297mm, margin: 0mm) | ||
| set text(font: "SimSun", size: 12pt) | ||
| set par(leading: 0pt) | ||
|
|
||
| // Shared drawing helpers for the form's borders, fields, and vertical labels. | ||
| let border = 0.48pt | ||
| let field(value) = if value == none { | ||
| [] | ||
| } else { | ||
| // Leave a small inset so entered text does not touch the cell border. | ||
| align(left + horizon)[#h(2mm)#value] | ||
| } | ||
| let vertical-label(..items) = align(center + horizon)[ | ||
| #stack(dir: ttb, spacing: 4mm, ..items) | ||
| ] | ||
| let area(value) = if value == none { | ||
| [] | ||
| } else { | ||
| align(left + top)[#value] | ||
| } | ||
| let signature() = align(left + bottom)[ | ||
| // Fixed positions match the original signature and seal fields. | ||
| #grid( | ||
| columns: (63.5mm, 16.9mm, 31.3mm, 1fr), | ||
| inset: 0pt, | ||
| align: left, | ||
| [ ], [负责人:], [ ], [单位盖章], | ||
| ) | ||
| #v(2.5mm) | ||
| #h(97mm)年 #h(12mm)月 #h(12mm)日 | ||
| ] | ||
| let assessment(value) = block(width: 100%, height: 100%)[ | ||
| #align(left + top)[#area(value)] | ||
| #place(bottom + left)[#signature()] | ||
| ] | ||
|
|
||
| // First page header and basic-information table. | ||
| place(top + center, dx: 0mm, dy: 54.6mm)[ | ||
| #text(size: 16pt)[#title] | ||
| ] | ||
|
|
||
| place(top + left, dx: 18.47mm, dy: 62.6mm)[ | ||
| // Column and row sizes reproduce the original merged-cell layout. | ||
| #grid( | ||
| columns: (23.9mm, 20.8mm, 22.1mm, 21.8mm, 25.7mm, 15.9mm, 37.8mm), | ||
| rows: (10.18mm, 10.18mm, 10.18mm, 162.1mm), | ||
| stroke: border, | ||
| inset: 0pt, | ||
| align: center + horizon, | ||
| [姓名], field(name), [政治面貌], field(political-status), [生源地], grid.cell(colspan: 2)[#field(hometown)], | ||
| [学院], grid.cell(colspan: 2)[#field(college)], [专业], field(major), [年级], field(grade), | ||
| [实践单位], grid.cell(colspan: 6)[#field(practice-unit)], | ||
| grid.cell(rowspan: 1)[#vertical-label[个][人][实][践][小][结]], | ||
| grid.cell(colspan: 6, inset: (left: 3.6mm, top: 3mm, right: 3.6mm, bottom: 2.6mm))[ | ||
| #area(practice-summary) | ||
| ], | ||
| ) | ||
| ] | ||
|
|
||
| // The source form continues the assessment sections on a second page. | ||
| pagebreak() | ||
|
|
||
| place(top + left, dx: 18.47mm, dy: 35.0mm)[ | ||
| // Assessment text is typeset at the top; the signature block stays at the bottom. | ||
| #grid( | ||
| columns: (9.54mm, 158.4mm), | ||
| rows: (98.9mm, 55.03mm, 59.23mm), | ||
| stroke: border, | ||
| inset: 0pt, | ||
| align: center + horizon, | ||
| [#vertical-label[实][践][单][位][评][议]], | ||
| grid.cell(inset: (left: 4mm, top: 4mm, right: 8.1mm, bottom: 3mm))[#assessment(practice-unit-assessment)], | ||
| [#vertical-label[学][院][意][见]], | ||
| grid.cell(inset: (left: 4mm, top: 4mm, right: 8.1mm, bottom: 3mm))[#assessment(college-opinion)], | ||
| [#vertical-label[学][校][意][见]], | ||
| grid.cell(inset: (left: 4mm, top: 4mm, right: 8.1mm, bottom: 3mm))[#assessment(school-opinion)], | ||
| ) | ||
| ] | ||
| } |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| #import "@preview/scut-social-practice-form:0.1.0": social-practice-form | ||
|
|
||
| #social-practice-form( | ||
| name: [张三], | ||
| political-status: [共青团员], | ||
| hometown: [广东省广州市], | ||
| college: [软件学院], | ||
| major: [软件工程], | ||
| grade: [2024 级], | ||
| practice-unit: [华南理工大学], | ||
| practice-summary: [在此输入个人社会实践小结。可直接使用多个段落编写较长内容。], | ||
| practice-unit-assessment: [在此输入实践单位评议。], | ||
| college-opinion: [在此输入学院意见。], | ||
| school-opinion: [在此输入学校意见。], | ||
| ) |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| [package] | ||
| name = "scut-social-practice-form" | ||
| version = "0.1.0" | ||
| entrypoint = "src/lib.typ" | ||
| authors = ["ya2yo <yayoy0015@gmail.com>"] | ||
| license = "MIT" | ||
| description = "A template for student social-practice registration forms." | ||
| keywords = ["form", "social-practice", "student"] | ||
| categories = ["office"] | ||
| repository = "https://github.com/ya2yo/scut-social-practice-form" | ||
|
|
||
| [template] | ||
| path = "template" | ||
| entrypoint = "main.typ" | ||
| thumbnail = "thumbnail.png" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What does SCUT mean? If it is an institution, the chosen name would be considered canonical and should be changed, unless this template is officially endorsed by the said institution. If you wish to make the template official, we have a formal (but not to hard to complete) verification process, let me know if that's something you want to do.