The dashboard

The dashboard is where a project opens. Ctrl+M goes back to it from any post.

Browse a collection

Each collection is a tab along the top. Within one:

• Search filters the entries as you type.
• Tags filters to entries with the tags you pick.
• All, Published, and Drafts filter by draft status, when the collection has a draft field.
• Cards shows each entry with its cover image. List shows more of them at once.
• The sort menu orders entries by Newest, Oldest, Title A-Z, or Recently modified, and by Order when the collection has an order field.

Click an entry to open it. New creates an entry in the collection, and SEO runs the SEO audit across the whole collection.

An entry your site’s build will reject gets a Build error label, and one it may trip on gets a Build warning. Point at the label to see what’s wrong, and click with problems beside the item count to show only those entries. It’s the same check Publish runs; see Build errors.

Folders of pages

A collection can keep pages inside other pages’ folders. A course is the usual case: courses/my-course/index.md is the course’s own page, and each lesson is a folder beside it with an index.md of its own. Zeku shows a folder like that as a section:

• A page with other pages in its folder says how many across the foot of its card, such as 17 pages inside. Click that to step inside, or right-click the card and choose Open section. The rest of the card opens the page, as on any card.
• Inside, the section’s own page comes first, labeled Section page, followed by the pages in it. In List view, the way in sits beside the page’s row.
• A folder of pages with no page of its own, such as a group of Starlight docs, shows as a folder card.
• The trail above the cards shows where you are. Click any step in it to go back up.
• Search and the filters look through every page in the section you’re in, however deep.

New creates the page in the section on screen, so inside a course it makes a lesson. Its Section menu reaches every section, and the address the page will have shows before you create it. To put the first pages inside a page, such as the first lesson of a new course, right-click it in the file tree and choose New entry here. Once a collection has sections, its cards offer New page inside too.

Zeku finds sections from your folders alone, so this works the same in any theme: a folder is a section when it holds pages besides its own index page. A collection kept in language folders has none, since its folders are languages, and List view sorted by Sidebar or Order keeps its own groups instead. To list a collection’s pages together, open it under Settings > Content > Collections and turn off Show folders of pages as sections. The choice is kept in the project’s .zeku/config.json.

Choose what a collection’s cards show

Open a collection under Settings > Content > Collections. Its Dashboard cards settings set how its entries look on the dashboard:

• Cover fit: Crop to fill, the default, fills each card’s cover with the picture and cuts off whatever doesn’t fit. Show whole image fits the whole picture inside the cover with a plain border around it, for tall or wide covers that cropping cuts off.
• Card fields: frontmatter fields to show on each card besides its title, date, description, tags, cover, and draft status, separated by commas, in the order the card shows them. Add a field lists the collection’s own fields to pick from. Each field shows its name as a label, and its value the way the frontmatter panel shows it: a checkbox, a date, a list of items, or a thumbnail for a picture. A card leaves out a field its entry leaves empty.
• Wrap field text: appears once a collection has card fields. Off, each value stays on one line, and a long one ends in an ellipsis. On, a long value, such as an address or a path, wraps onto as many lines as it needs. There’s no character limit, so a wrapped value always shows in full.

These choices describe your project, so they’re kept in its .zeku/config.json and follow it to other computers.

Edit many entries at once

Select entries with Ctrl-click, or Shift-click to select a run of them. A bar appears with actions for everything selected:

• Add or remove tags
• Mark as drafts, or publish
• Set a frontmatter field to one value
• Move to the Trash

Click Clear to drop the selection.

Starlight sites

In a Starlight site’s docs collection, the sort menu adds Sidebar, which orders entries the way your sidebar config shows them. See Starlight sites.