Club Handbook¶
The Club Handbook is your club's built-in knowledge base. Use it to store role guides, meeting scripts, tips, and any reference material you want members to be able to find in one place — no more hunting through old emails or group chats.
Members see the Handbook in the left sidebar and can browse it like a mini-website. Officers have full control: create, edit, publish, and delete pages at any time.
Who can do what?¶
| Action | Who |
|---|---|
| Browse and read published pages | All active members |
| Create, edit, delete pages | Club officers |
| See unpublished drafts | Club officers only |
| See "Officers Only" pages | Club officers only |
Creating a page¶
- Click Club Handbook in the sidebar.
- Click Manage Handbook (top right of the landing page).
- Click New Page.
- Enter a Title and write your content in the editor.
- Optionally type a URL slug — the part that appears in the page's web address. Leave it blank and it'll be generated from the title automatically.
- Choose who can see the page (see Visibility below).
- Check Published if you want members to see it right away — or leave it unchecked to save a draft.
- Click Create Page.
About the URL slug: It's the portion after
/pages/in the page's address. If your page is titled "Toastmaster Guide" the slug is auto-generated astoastmaster-guide. You can change it anytime by editing the page, but changing the slug breaks any existing links or bookmarks that point at the old URL. If you clear the slug field on edit, it will regenerate from the current title — same caveat applies.
The editor toolbar¶
The editor supports rich formatting:
| Button | What it does |
|---|---|
| H2 / H3 / H4 | Section headings (H1 is reserved for the page title) |
| B / I / U / S | Bold, italic, underline, strikethrough |
| Color / Highlight | Text color and background highlight |
| Lists | Numbered or bulleted lists |
| Indent | Increase or decrease list indentation |
| Align | Left, center, right, or justify |
| Blockquote | Indented quote block |
| Code block | Monospace code or script text |
| Link | Insert a hyperlink to any URL |
| Folder icon | Link to a file from your Club Files |
| Eraser | Remove all formatting from selected text |
Linking to club files¶
To link a page to a file you've uploaded in Club Files:
- Place your cursor where you want the link (or select existing text to use as the link label).
- Click the folder icon in the toolbar.
- Search for the file by name or folder.
- Click the file — it's inserted as a link.
Heads up about file visibility. Files that live in an officer-only folder are tagged with a yellow "Officers Only" badge in the file picker. If you insert one of those files into a page that's visible to all members, members will see the link but get a "Page not found" error when they click it (because the underlying file is officer-only). Avoid linking to officer-only files from member-visible pages — or move the file to a member-visible folder first. After saving, you'll see a warning at the top of the page if any embed leaks across visibility.
Note: If you later delete the file from Club Files, the link in the handbook page will stop working. There's no automatic cleanup in the current version.
Embedding audio and video¶
Club Files supports MP4, WebM, MOV (video up to 400 MB) and MP3, M4A, OGG, WAV (audio up to 50 MB). You can drop a video or audio player straight into a handbook page so members can watch or listen inline — no separate download needed.
To embed:
- Place your cursor where you want the player.
- Click the film icon in the toolbar (next to the folder-icon button).
- The picker opens filtered to audio + video files. Pick one.
- For video: the picker switches to a "Step 2 of 2 — optional" view to choose a poster image (the still that shows before someone hits play). Pick an image, or click Done — skip poster.
- For audio: the picker closes after the pick — no poster step.
The chip you see in the editor ([Video: filename.mp4]) is a placeholder. On the published page, members see a real player.
Officer-only embeds on member-visible pages. Same rule as links: if you embed an officer-only file on a page visible to all members, members see "(unavailable)" where the player would be. You'll see a warning at save time. Officers viewing the same page see the player along with a small "Hidden from members" badge so the visibility mismatch is obvious.
Posters are per-file, not per-embed. Setting a poster on a video changes it everywhere that video is embedded across your handbook. To clear an existing poster, ask a developer for now (UI for clearing is on the roadmap).
Format tip. MP4 with H.264 video and AAC audio plays in every browser. WebM and MOV may not play on older devices. If members report a black or silent player, re-encode to MP4.
Visibility settings¶
Each page has two visibility controls:
Who can see this page? - Members — visible to all active members (once published). - Officers Only — only club officers can see it, even after publishing. Use this for internal procedures or sensitive information.
Published? - Unchecked = Draft — only officers can see it. Useful while you're writing. - Checked = Published — visible to whoever matches the visibility setting above.
You can toggle published status at any time from the Manage Handbook page without opening the editor.
Managing pages¶
Go to Club Handbook → Manage Handbook to see all pages, including drafts.
From the table you can: - Edit — open the full editor. - Publish / Unpublish — toggle live status with one click. - Delete — permanently remove the page (a confirmation step is shown first).
Pages are listed newest first on the member-facing landing page.
Frequently asked questions¶
Can members comment on pages? Not in the current version. Pages are read-only for members.
Can I reorder pages? Not manually in the current version. Pages always appear newest first.
Can I add images? Not directly — image uploads are not supported yet. You can link to files stored in Club Files, but not embed images inline.
What happens if I delete a file that's linked in a page? The link will stop working (404) but the page itself will not be affected. You'll need to edit the page and update or remove the broken link manually.