diff --git a/docs/images/screenshots/01-flat-index.png b/docs/images/screenshots/01-flat-index.png index d3a71cc..64f8c0f 100644 Binary files a/docs/images/screenshots/01-flat-index.png and b/docs/images/screenshots/01-flat-index.png differ diff --git a/docs/images/screenshots/02-article.png b/docs/images/screenshots/02-article.png index 9902f4e..f67d091 100644 Binary files a/docs/images/screenshots/02-article.png and b/docs/images/screenshots/02-article.png differ diff --git a/docs/images/screenshots/03-manage-your-articles.png b/docs/images/screenshots/03-manage-your-articles.png index eda3763..ed50b94 100644 Binary files a/docs/images/screenshots/03-manage-your-articles.png and b/docs/images/screenshots/03-manage-your-articles.png differ diff --git a/docs/images/screenshots/04-add-article.png b/docs/images/screenshots/04-add-article.png index c003afe..0302228 100644 Binary files a/docs/images/screenshots/04-add-article.png and b/docs/images/screenshots/04-add-article.png differ diff --git a/docs/images/screenshots/05-approval-queue.png b/docs/images/screenshots/05-approval-queue.png index b891f72..db2b91c 100644 Binary files a/docs/images/screenshots/05-approval-queue.png and b/docs/images/screenshots/05-approval-queue.png differ diff --git a/docs/images/screenshots/06-search-results.png b/docs/images/screenshots/06-search-results.png index 488fb96..47897cf 100644 Binary files a/docs/images/screenshots/06-search-results.png and b/docs/images/screenshots/06-search-results.png differ diff --git a/docs/images/screenshots/07-acp-configuration.png b/docs/images/screenshots/07-acp-configuration.png index 9bb10b2..c432f47 100644 Binary files a/docs/images/screenshots/07-acp-configuration.png and b/docs/images/screenshots/07-acp-configuration.png differ diff --git a/docs/images/screenshots/08-category-tree.png b/docs/images/screenshots/08-category-tree.png index 1096371..eee3b71 100644 Binary files a/docs/images/screenshots/08-category-tree.png and b/docs/images/screenshots/08-category-tree.png differ diff --git a/docs/images/screenshots/09-board-search-kb-block.png b/docs/images/screenshots/09-board-search-kb-block.png index 83f4e09..3b7343a 100644 Binary files a/docs/images/screenshots/09-board-search-kb-block.png and b/docs/images/screenshots/09-board-search-kb-block.png differ diff --git a/docs/images/screenshots/10-advanced-search-option.png b/docs/images/screenshots/10-advanced-search-option.png index ed1409d..0e0854f 100644 Binary files a/docs/images/screenshots/10-advanced-search-option.png and b/docs/images/screenshots/10-advanced-search-option.png differ diff --git a/docs/images/screenshots/11-acp-search-settings.png b/docs/images/screenshots/11-acp-search-settings.png index 7ee01fe..2105c79 100644 Binary files a/docs/images/screenshots/11-acp-search-settings.png and b/docs/images/screenshots/11-acp-search-settings.png differ diff --git a/docs/images/screenshots/12-recent-changes.png b/docs/images/screenshots/12-recent-changes.png index e750348..de26e67 100644 Binary files a/docs/images/screenshots/12-recent-changes.png and b/docs/images/screenshots/12-recent-changes.png differ diff --git a/docs/images/screenshots/README.md b/docs/images/screenshots/README.md index fddfc8e..def6ac4 100644 --- a/docs/images/screenshots/README.md +++ b/docs/images/screenshots/README.md @@ -1,6 +1,14 @@ # Knowledge Base screenshots -Taken with Playwright on a throwaway phpBB 3.3.19 board (prosilver, SQLite) filled with test articles, as an administrator. The flat article index is the default; the category tree needs **Hierarchical category browsing** switched on under **Extensions > Knowledge Base > Configuration**. +Taken with Playwright by `phpbb-test-board/screenshots.py` in [phpbb-release-tools](https://github.com/phpbbmodders/phpbb-release-tools) on a throwaway phpBB 3.3 board (prosilver, SQLite) filled with example articles and forum questions, as an administrator. The flat article index is the default; the category tree needs **Hierarchical category browsing** switched on under **Extensions > Knowledge Base > Configuration**. + +A change that alters a page shown here means retaking them, with the extension's own entry in that script: + +```bash +phpbb-release-tools/phpbb-test-board/screenshots.py path/to/knowledgebase -o path/to/knowledgebase/docs/images/screenshots --seed path/to/seed-forum/bin/seed-standard-fixtures.php +``` + +The two ACP pages are taken in full, so a setting further down the page is not cut off. ## The flat article index @@ -52,13 +60,13 @@ Results of a search on the Knowledge Base's own search page. ## ACP configuration -**Extensions > Knowledge Base > Configuration**, with the hierarchical browsing and alternative stylesheet settings. +**Extensions > Knowledge Base > Configuration**, the whole page: the announcement and changelog forums, hierarchical browsing, the alternative stylesheet, the **Recent changes feed** (RSS, Atom or both), the number of articles per page, the description length and the sorting order, then the attachment settings, the review teams and the contact group. ![The configuration page in the ACP](07-acp-configuration.png) ## Knowledge Base articles in the board's search -A search in phpBB's own search for `backup`. The **Knowledge Base (34)** block sits above the forum results and lists the best matches with their category, a snippet with the word marked and a link to all of them; the forum post that asks about backups is the first of the forum results below it. Switch the block off, or set how many articles it lists, in the ACP. +A search in phpBB's own search for `backup`. The **Knowledge Base (4)** block sits above the forum results and lists the best matches with their category, a snippet with the word marked and a link to all of them; the forum post that asks about backups is the first of the forum results below it. Switch the block off, or set how many articles it lists, in the ACP. ![The board search with a Knowledge Base block above a forum post](09-board-search-kb-block.png)