Chic-headers (chic-hdr) is a Typst package for creating elegant headers and footers

Usage

To use this library through the Typst package manager (for Typst 0.6.0 or greater), write #import "@preview/chic-hdr:0.1.0": * at the beginning of your Typst file. Once imported, you can start using the package by writing the instruction #show: chic.with() and giving any of the chic functions inside the parenthesis ().

Reference

Note: For a detailed explanation of the functions and parameters, see Chic-header’s Manual.pdf.

While using #show: chic.with(), you can give the following parameters inside the parenthesis:

• width: Indicates the with of headers and footers in all the document (deafult is 100%).
• skip: Which pages must be skipped for setting its header and footer. Other porperties changed with chic-height() or chic-offset() are preserved. (default is ()).
• even: Header and footer for even pages. Here, only chic-header(), chic-footer() and chic-separator() functions will take effect. Other functions must be given as an argument of chic().
• odd: Sets the header and footer for odd pages. Here, only chic-header(), chic-footer() and chic-separator() functions will take effect. Other functions must be given as an argument of chic().
• ..functions(): These are a variable number of arguments that corresponds to Chic-header’s style functions.

Functions

1. chic-header() - Sets the header content.
   • left-side: Content displayed in the left side of the header (default is none).
   • center-side: Content displayed in the center of the header (default is none).
   • right-side: Content displayed in the right side of the header (default is none).
2. chic-footer() - Sets the footer content.
   • left-side: Content displayed in the left side of the footer (default is none).
   • center-side: Content displayed in the center of the footer (default is none).
   • right-side: Content displayed in the right side of the footer (default is none).
3. chic-separator() - Sets the separator for either the header, the footer or both.
   • on: Where to apply the separator. It can be "header", "footer" or "both" (default is "both").
   • gutter: How much spacing insert arround the separator (default is 0.65em).
   • (unnamed): A length for a line(), a stroke for a line(), or a custom content element.
4. chic-height() - Sets the height of either the header, the footer or both.
   • on: Where to change the height. It can be "header", "footer" or "both" (default is "both").
   • (unnamed): A relative length (the new height value).
5. chic-offset() - Sets the offset of either the header, the footer or both (relative to the page content).
   • on: Where to change the offset It can be "header", "footer" or "both" (default is "both).
   • (unnamed): A relative length (the new offset value).
6. chic-page-number() - Returns the current page number. Useful for header and footer sides. It doesn’t take any parameters.
7. chic-heading-name() - Returns the previous heading name. If there’s no previous headings, it returns the next heading name. Finally, if there’s no headings ahead, it returns nothing.

Gallery

Header with chic-heading-name() at left, and chic-page-number() at right. There’s a chic-separator() of 1pt only for the header.

Footer with chic-page-number() at right, and a custom chic-separator() showing “end of page (No. page)” between 9 ~ symbols at each side.

Changelog

Version 0.1.0

• Initial release
• Implemented chic-header(), chic-footer(), chic-separator(), chic-height(), chic-offset(), chic-page-number(), and chic-heading-name() functions