BookStack/resources/views
Dan Brown bba7dcce49
Auth: Refactored OIDC RP-logout PR code, Extracted logout
Extracted logout to the login service so the logic can be shared instead
of re-implemented at each stage. For this, the SocialAuthService was
split so the driver management is in its own class, so it can be used
elsewhere without use (or circular dependencies) of the
SocialAuthService.

During review of #4467
2023-12-06 13:49:53 +00: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 Styles: Aligned empty state alignment & consistency 2023-10-23 11:53:19 +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 Styles: Aligned empty state alignment & consistency 2023-10-23 11:53:19 +01:00
entities Styles: Aligned empty state alignment & consistency 2023-10-23 11:53:19 +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 Styles: Aligned empty state alignment & consistency 2023-10-23 11:53:19 +01:00
layouts Auth: Refactored OIDC RP-logout PR code, Extracted logout 2023-12-06 13:49:53 +00: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 Editors: Adjusted new design for mobile and dark mode 2023-10-14 17:10:29 +01:00
search Guest control: Cleaned methods involved in fetching/handling 2023-09-16 13:18:35 +01:00
settings Dropdowns: Fixed bad direction logic, added dynmaic height 2023-11-07 15:07:11 +00:00
shelves Styles: Aligned empty state alignment & consistency 2023-10-23 11:53:19 +01:00
tags Played around with a new app structure 2023-05-17 17:56:55 +01:00
users My Account: Updated and started adding to tests 2023-10-19 14:18:42 +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