Title pages

Bookly provides two functions to create title pages, one for a book and one for a thesis. They are passed to the title-page argument of #bookly.with.

Note
For both title pages, the title and the author of the document are taken from the title and author arguments of #bookly.with. The colors follow the primary color of the document.

Book title page

#book-title-page creates a cover page followed by an inner title page.

#book-title-page(
  subtitle: "Book subtitle",
  edition: "First edition",
  institution: "Institution",
  series: "Discipline",
  year: datetime.today().year(),
  cover: none,
  logo: none,
  version-usage: none,
  copyright: none,
  show-cover-author: true,
)
Argument
<subtitle>: "Book subtitle"string|content

Subtitle of the book.

Argument
<edition>: "First edition"string|content

Edition of the book. Set it to none to hide it.

Argument
<institution>: "Institution"string|content

Name of the institution, displayed in the footer band of the cover.

Argument
<series>: "Discipline"string|content

Name of the series, displayed in the header band of the cover.

Argument
<year>: datetime.today().year()int|string|content

Year of publication, used in the default copyright notice.

Argument
<cover>: noneimage|content

Cover image of the book.

Argument
<logo>: noneimage

Logo displayed at the bottom of the inner title page.

Argument
<version-usage>: nonestring|content

Description of the version usage of the book (version number, date, licensing information, …), displayed at the bottom of the inner title page. If none, a default notice translated in the language of the document is used.

Argument
<copyright>: nonestring|content

Copyright information, displayed at the bottom of the inner title page. If none, it is set to “© author, year”.

Argument
<show-cover-author>: truebool

If true, the author name is displayed on the cover page.

Example

#show: bookly.with(
  title: "Bookly",
  author: "Mathieu Aucejo",
  title-page: book-title-page(
    subtitle: "User's guide",
    edition: "Version 5.3.0",
    series: "Typst book series",
    institution: "Typst community",
    cover: image("images/bookly-logo.png", width: 45%),
  ),
)
Book cover page Cover pageBook inner title page Inner title page

Thesis title page

#thesis-title-page creates the title page of a doctoral thesis or of a French habilitation.

#thesis-title-page(
  type: "phd",
  school: "School name",
  doctoral-school: "Name of the doctoral school",
  supervisor: ("Supervisor name",),
  cosupervisor: none,
  laboratory: "Laboratory name",
  defense-date: "01 January 1970",
  discipline: "Discipline",
  specialty: "Specialty",
  committee: (:),
  logo: none,
)
Argument
<type>: "phd"string

Type of thesis. Two values are possible:

  • "phd" for a doctoral thesis;
  • "habilitation" for a French habilitation.
Argument
<school>: "School name"string|content

Name of the institution where the thesis was prepared.

Argument
<doctoral-school>: "Name of the doctoral school"string|content

Name of the doctoral school.

Argument
<supervisor>: ("Supervisor name",)array

Name(s) of the thesis supervisor(s) or of the guarantor of the habilitation.

Argument
<cosupervisor>: nonearray|none

Name(s) of the thesis co-supervisor(s).

Argument
<laboratory>: "Laboratory name"string|content

Name of the research laboratory.

Argument
<defense-date>: "01 January 1970"string|content

Date of the thesis defense.

Argument
<discipline>: "Discipline"string|content

Name of the discipline.

Argument
<specialty>: "Specialty"string|content

Name of the specialty.

Argument
<committee>: (:)array

Members of the thesis committee. Each element of the array is a dictionary with the following keys:

  • name: name of the committee member;
  • position: position of the committee member (e.g., “Associate Professor”, “Professor”);
  • affiliation: affiliation of the committee member (e.g., “University Name”);
  • role: role of the committee member (e.g., “Chair”, “Member”, “Reviewer”).
Argument
<logo>: noneimage

Logo of the institution.

Example

#let committee = (
  (
    name: "Hari Seldon",
    position: "Full Professor",
    affiliation: "Streeling University",
    role: "President",
  ),
  (
    name: "Gal Dornick",
    position: "Associate Professor",
    affiliation: "Synnax University",
    role: "Reviewer",
  ),
)

#show: bookly.with(
  title: "Bookly",
  author: "Mathieu Aucejo",
  title-page: thesis-title-page(
    supervisor: ("Supervisor A", "Supervisor B"),
    cosupervisor: ("Co-supervisor A",),
    committee: committee,
  ),
)
Thesis title page