template.typ

#let ECTScoef = state("coef", 1)

#let conf(
  logo,
  schoolname,
  degree,
  subject,
  major,
  totalcredits,
  studentname,
  content,
) = {
  set page(paper: "us-letter", margin: (x: 2.37cm))

  align(center)[
    #image(logo, width: 60%)
    #set text(font: "Times New Roman", weight: "bold")

    #text(size: 30pt)[#schoolname]

    #text(size: 24.5pt)[Course Description]

    #set text(size: 17pt)
    #degree of #subject

    #major

    Name: #studentname

    #v(30pt)
    #text(size: 14pt)[(including all basic and specialized courses)]
  ]


  set page(
    header: {
      set text(font: "Arial", size: 9.5pt)
      grid(
        columns: (1fr, 1fr),
        align: (left, right),
        schoolname,
        ([Course Description], major, degree).join([-]),
        grid.hline(),
        inset: 2pt,
      )
    },
    numbering: "1",
  )

  show heading.where(depth: 1): set block(above: 1em)
  show heading.where(depth: 2): set block(above: 3em)

  counter(page).update(1)

  outline(title: text(font: "Calibri", size: 14pt, weight: "bold", fill: rgb("#4472C4"))[Content], indent: 1.5em)

  pagebreak()

  ECTScoef.update(240 / totalcredits)

  set text(font: "Arial", size: 9.5pt)
  [
    = Foreword
    In contrast to the European ECTS system—where credit points are based on the total student workload, including lectures, self-study, assignments, and exam preparation—the Chinese university credit system primarily accounts for classroom contact hours.

    At Harbin Institute of Technology at Weihai, students must complete 170 credits over four years to earn a Bachelor's degree. In comparison, a typical four-year bachelor's degree in Europe requires 240 ECTS credits, based on a full workload of approximately 1500–1800 hours per academic year.

    Considering this structural difference, the Chinese credit system at our institution should be converted to ECTS using a factor of approximately #{ context calc.round(ECTScoef.get(), digits: 2) } (i.e., 240/#totalcredits). This conversion ensures a more accurate equivalence when evaluating academic progress and qualifications in an international context.
  ]

  content
}


#let f1dp(num) = {
  if type(num) == int or calc.round(num) == num {
    str(num) + ".0"
  } else {
    str(num)
  }
}

#let studyhours(hours, weeks) = {
  let times = ()
  if hours > 0 { times.push(f1dp(hours)) }
  if weeks > 0 {
    if weeks > 1 { times.push(f1dp(weeks) + " weeks") } else { times.push(str(weeks) + " week") }
  }

  times.join(" + ")
}

#let category(name, modules) = {
  pagebreak()
  heading(name, numbering: "1000")

  
    let totalcredits = 0
    let totalhours = 0
    let totalweeks = 0

    for module in modules {
      totalcredits += module.data.credits
      totalhours += module.data.hours
      totalweeks += module.data.weeks
    }


    table(
      columns: (1fr, 2fr),
      inset: 1.5em,
      [
        Assigned Modules:\
        *Total ECTS Credits: #context f1dp(calc.round(totalcredits * ECTScoef.get(), digits: 2))*\
        *Total Study Hours: #studyhours(totalhours, totalweeks)*
      ],
      {
        for (idx, module) in modules.enumerate(start: 1) {
          let number = context counter(heading).get().first() * 1000 + idx
          [#number #h(1em) #module.data.name \ ]
        }
      },
    )

    for (idx, module) in modules.enumerate(start: 1) {
      let number = context counter(heading).get().first() * 1000 + idx
      (module.render)(number)
    }
  
}

#let module(
  name: "",
  duration: 1,
  credits: 0,
  hours: 0,
  weeks: 0,
  score: 0,
  outcomes: (),
  content: (),
  requires: none,
  courseform: "Lecture",
  examform: "Written Examination",
) = (
  data: (
    name: name,
    duration: duration,
    credits: credits,
    hours: hours,
    weeks: weeks,
  ),
  render: number => {
    [== Module: #name]

    table(
      columns: (1fr,) * 4,
      [*Number:*],
      number,
      [*Duration:*],
      {
        if duration <= 1 {
          [#duration Semester]
        } else {
          [#duration Semesters]
        }
      },

      [*Credits:*], f1dp(credits), [*ECTS Credits:*], context f1dp(calc.round(credits * ECTScoef.get(), digits: 2)),
      [*Language:*], "Chinese", [*Study Hours:*], studyhours(hours, weeks),
      [*Score:*],
      {
        if type(score) == array {
          score.map(s => f1dp(s)).join(" & ")
        } else {
          f1dp(score)
        }
      },
    )
    table(
      columns: (1fr, 3fr),
      [*Learning Outcomes:*],
      [
        The Students\
        #outcomes
      ],

      [*Content:*], content,
      [*Required Modules:*],
      {
        if requires == none {
          "None"
        } else {
          requires.map(item => item.data.name).join(",")
        }
      },

      [*Teaching Method:*], courseform,
      [*Assessment:*], examform,
    )
  },
)