1
0
mirror of https://github.com/BookStackApp/BookStack.git synced 2024-10-30 07:32:39 +01:00
BookStack/resources/views
Dan Brown 1d91b4d8a6
PWA Manifest: Tweaks during review of PR #4430
- Updated to go through HomeController with the builder as a helper
  class.
- Extracted some reapeated items into variables in manifest.
- Updated background color to match those used by BookStack.
- Removed reference of icon.ico since its not intended to be used.
- Added tests to cover functionality.

Review of #4430
2023-10-02 15:54:39 +01:00
..
api-docs API Docs: Allowed multi-paragraph descriptions 2023-06-20 23:44:39 +01:00
attachments Allowed attachment drag via main text link 2023-05-22 20:23:19 +01:00
auth Updated email confirmation flow so confirmation is done via POST 2022-11-12 15:11:59 +00:00
books Guest control: Cleaned methods involved in fetching/handling 2023-09-16 13:18:35 +01:00
chapters Guest control: Cleaned methods involved in fetching/handling 2023-09-16 13:18:35 +01:00
comments Comments: Tweaked design to be more consistent and compact 2023-06-28 13:41:14 +01:00
common Guest control: Cleaned methods involved in fetching/handling 2023-09-16 13:18:35 +01:00
entities Simplified and aligned handling of mixed entity endpoints 2023-09-10 15:19:23 +01:00
errors Guest control: Cleaned methods involved in fetching/handling 2023-09-16 13:18:35 +01:00
exports Updated migration to carry across more colors, updated export 2023-01-28 17:49:48 +00:00
form Shelf permissions: reverted create removal 2023-07-12 22:04:05 +01:00
help Added ordered/unordered WYSIWYG list shortcuts 2022-07-26 16:43:15 +01:00
home Views: Rolled out ID to similar recent activity lists 2023-09-11 18:50:39 +01:00
layouts PWA Manifest: Tweaks during review of PR #4430 2023-10-02 15:54:39 +01:00
mfa Rolled out use of seperate link color style 2023-01-28 16:06:11 +00:00
misc Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
pages Locales: Performed cleanup and alignment of locale handling 2023-09-17 13:31:38 +01:00
search Guest control: Cleaned methods involved in fetching/handling 2023-09-16 13:18:35 +01:00
settings Notifications: User watch list and differnt page watch options 2023-08-14 13:11:18 +01:00
shelves Guest control: Cleaned methods involved in fetching/handling 2023-09-16 13:18:35 +01:00
tags Played around with a new app structure 2023-05-17 17:56:55 +01:00
users Merge branch 'tusharnain4578/development' into development 2023-09-17 22:29:06 +01:00
vendor Locales: More use of locale objects, Addressed failing tests 2023-09-17 16:20:21 +01:00
readme.md Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00

BookStack Views

All views within this folder are Laravel blade views.

Overriding

Views can be overridden on a per-file basis via the visual theme system. More information on this can be found within the dev/docs/visual-theme-system.md file within this project.

Convention

Views are broken down into rough domain areas. These aren't too strict although many of the folders here will often match up to a HTTP controller.

Within each folder views will be structured like so:

- folder/
    - page-a.blade.php
    - page-b.blade.php
    - parts/
        - partial-a.blade.php
        - partial-b.blade.php
    - subdomain/
        - subdomain-page-a.blade.php
        - subdomain-page-b.blade.php
        - parts/
            - subdomain-partial-a.blade.php
            - subdomain-partial-b.blade.php

If a folder contains no pages at all (For example: attachments, form) and only partials, then the partials can be within the top-level folder instead of pages to prevent unneeded nesting.

If a partial depends on another partial within the same directory, the naming of the child partials should be an extension of the parent. For example:

- tag-manager.blade.php
- tag-manager-list.blade.php
- tag-manager-input.blade.php