%%table-striped
Using Captures
Capture lets you save things you find on the web into GeoHazardWatch with one click — the page's link, its title, and any text you have highlighted — without leaving the page you're reading.
Captures land on your own daily captures page (for example Captures — yourname — 2026-07-20), where they are searchable, versioned, and listed in Recent Changes like any other page content.
Installing the Capture button
- Open /capture/install (you must be logged in).
- Drag the 📌 Capture to GeoHazardWatch button onto your browser's bookmarks / favorites bar.
- That's it — the button works on any website you visit.
Install the button from the address you normally use to reach GeoHazardWatch — the bookmarklet is built for that address, and your browser must be able to reach it when you click.
Capturing
- On any web page, highlight the text you want to keep (optional — you can also capture just the link).
- Click the Capture bookmark. A small popup opens with everything pre-filled:
- Save to page — where the capture will go (your daily captures page by default; change it to any page you can edit)
- Source title — the web page's title
- Source URL — the web page's address
- Quote / selection — the text you highlighted, editable before saving
- Click Save capture.
Each capture is appended to the target page as its own section — the source link becomes the heading, your highlighted text follows as ordinary prose, and the date closes it off:
## [The Page's Title|https://example.com|target='_blank']
The text you highlighted appears here, as normal page text you can edit like any other.
*(captured 2026-07-20)*
----
## [The Next Thing You Captured|https://example.org|target='_blank']
A second capture, later the same day.
*(captured 2026-07-20)*
A ---- rule is drawn between captures, so a day's page reads as a list of sections rather than a run-on block. The rule goes between entries — the page never ends on one.
If the target page doesn't exist yet, it is created for you.
Things to know
| Question | Answer |
|---|---|
| Where do my captures go? | Your own daily page — one per user per day, so captures are never mixed between users. |
| Who can see my captures? | Capture pages are created __private__ — only you (and administrators) can see them. Pages you deliberately capture into (like a shared topic page) keep their existing visibility. |
| Can I send a capture somewhere else? | Yes — edit __Save to page__ in the popup before saving. Any page you're allowed to edit works. |
| Can I capture without highlighting text? | Yes — the link and title are captured on their own. |
| Can I trim the quote first? | Yes — the selection is editable in the popup before you save. |
| Is there a length limit? | Selections are capped at 8,000 characters. Very long selections are trimmed. |
| Why does the popup ask me to log in? | Captures are saved as you — the popup uses your normal GeoHazardWatch login. Log in once and capture again. |
For administrators
Capture is an optional feature, disabled by default. To enable it, set in the instance configuration:
ngdpbase.capture.enabled—trueto enable the/captureroutes (defaultfalse; when disabled they return 404)ngdpbase.capture.default-page— the default target page pattern, defaultCaptures — {username} — {date}. The{username}and{date}tokens are replaced per capture; point it at a journal day-page pattern to send captures there instead.ngdpbase.capture.keywords— keywords applied to pages the capture flow creates, default["capture"].ngdpbase.capture.private— whether capture-created pages are private, defaulttrue. Appending to an existing page never changes that page's privacy.
Saving a capture requires the user to have page-edit (existing target page) or page-create (new target page) permission.
No comments yet.