BookStack/resources/views
Dan Brown a61c9c5e98
Reorgranised blade view files to form a convention
- Primarily moved and re-organised view files.
- Included readme within views to document the convention.
- Fixed some issues with page field select list in previous commit.
- Tweaked some route names while going through.
- Split some views out further.

Closes #2805
2021-08-22 13:17:32 +01:00
..
api-docs Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
attachments Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
auth Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
books Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
chapters Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
comments Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
common Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
entities Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
errors Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
form Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
home Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
layouts Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
mfa Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
misc Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
pages Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
search Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
settings Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
shelves Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
users Reorgranised blade view files to form a convention 2021-08-22 13:17:32 +01:00
vendor Revert "Added app logo to outgoing emails" 2021-05-26 17:13:59 +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