Skip to content

yorkulibraries/dsi.library.yorku.ca

Repository files navigation

dsi.library.yorku.ca

This site is built with Zensical. The sections below walk through the most common update tasks.

How to Update

Adding New Pages or Editing Existing Pages

  1. Create a fork or a branch of this repository.
  2. Work locally on your own machine, or on GitHub editing existing or creating new Markdown files.
  3. Commit your changes. Write a good commit message. Think of this the way you would document changes or maintain a revision history for an institutional document.
  4. Open a Pull Request to propose your changes for review.

New to Git or GitHub? The Software Carpentry Version Control with Git course is a solid starting point, including for collaborative workflows.

Changing Site Structure or Navigation

Navigation is configured in zensical.toml. The nested array in that file controls how the site navigation is organized, and it corresponds directly to how content is structured in the docs folder. Changes to navigation and changes to the docs folder structure go hand in hand.

Working with Images

Store images in the docs/images folder. To link to or embed an image anywhere on the site, use the path: /images/filename.ext

⚠️ Caution: Files to Leave Alone

Unless you have a specific reason and are confident in what you're doing, do not edit or remove the following:

  • .github/workflows
  • CNAME
  • docs/stylesheets/extra.css

Contributors

Languages