New Reflectable package for reference docs

assets/css/layouts/reference.css

@@ -169,6 +169,9 @@ html {
 	font-size: var(--text-sm);
 	margin-bottom: var(--spacing-6);
 }
+.reference-meta:not(:has(:first-child)) {
+	display: none;
+}
 .reference-meta li {
 	margin-bottom: var(--spacing-2);
 }

assets/css/site/types.css

@@ -18,7 +18,8 @@
 .type.type-boolean {
 	background: var(--color-purple-400);
 }
-.type.type-array {
+.type.type-array,
+.type.type-callable {
 	background: var(--color-aqua-400);
 }
 .type.type-object,

content/docs/2_reference/4_objects/cms/0_app/reference-class.txt

@@ -1,7 +1,3 @@
-Title: $kirby
-
-----
-
 Name: Kirby
 
 ----

content/docs/2_reference/4_objects/cms/0_block/reference-class.txt

@@ -1,7 +1,5 @@
-Title: $block
+Name: Block
 
 ----
 
 Class: Kirby\Cms\Block
-
-----

content/docs/2_reference/4_objects/cms/0_blocks/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $blocks
+Name: Blocks
 
 ----
 

content/docs/2_reference/4_objects/cms/0_file/reference-class.txt

@@ -1,56 +1,56 @@
-Title: $file
-
-----
-
-Class: Kirby\Cms\File
-
-----
-
-Proxies:
-- Kirby\Filesystem\File
-- Kirby\Image\Image
-
-----
-
-Text:
-
-You can extend this set of methods with (link: docs/reference/plugins/extensions/file-methods text: custom file methods).
-
-## How to get a `$file` object
-
-You can get a `$file` object to use with these methods by fetching it from the `$site`, a `$page` or a `$user` object.
-
-### Site file
-```php
-<?php if ($file = $site->files()->first()): ?>
-<img src="<?= $file->url() ?>" alt="">
-<?php endif ?>
-```
-
-### Page file
-```php
-<?php if ($file = $page->files()->first()): ?>
-<img src="<?= $file->url() ?>" alt="">
-<?php endif ?>
-```
-
-### User file
-```php
-<?php if ($file = $user->files()->first()): ?>
-<img src="<?= $file->url() ?>" alt="">
-<?php endif ?>
-```
-
-<info>
-Note how we use an if statement here to check if we have a file object before we call the `url()` method to prevent errors in case the page doesn't have any files. Never forget to do this in your own code.
-</info>
-
-## Examples
-
-### Resizing a file
-
-```php
-<?php if ($image = $page->image('myimage.jpg')): ?>
-<img src="<?= $image->resize(300)->url() ?>" alt="">
-<?php endif ?>
-```
+Name: File
+
+----
+
+Class: Kirby\Cms\File
+
+----
+
+Proxies:
+- Kirby\Filesystem\File
+- Kirby\Image\Image
+
+----
+
+Text:
+
+You can extend this set of methods with (link: docs/reference/plugins/extensions/file-methods text: custom file methods).
+
+## How to get a `$file` object
+
+You can get a `$file` object to use with these methods by fetching it from the `$site`, a `$page` or a `$user` object.
+
+### Site file
+```php
+<?php if ($file = $site->files()->first()): ?>
+<img src="<?= $file->url() ?>" alt="">
+<?php endif ?>
+```
+
+### Page file
+```php
+<?php if ($file = $page->files()->first()): ?>
+<img src="<?= $file->url() ?>" alt="">
+<?php endif ?>
+```
+
+### User file
+```php
+<?php if ($file = $user->files()->first()): ?>
+<img src="<?= $file->url() ?>" alt="">
+<?php endif ?>
+```
+
+<info>
+Note how we use an if statement here to check if we have a file object before we call the `url()` method to prevent errors in case the page doesn't have any files. Never forget to do this in your own code.
+</info>
+
+## Examples
+
+### Resizing a file
+
+```php
+<?php if ($image = $page->image('myimage.jpg')): ?>
+<img src="<?= $image->resize(300)->url() ?>" alt="">
+<?php endif ?>
+```

content/docs/2_reference/4_objects/cms/0_files/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $files
+Name: Files
 
 ----
 

content/docs/2_reference/4_objects/cms/0_language/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $language
+Name: Language
 
 ----
 

content/docs/2_reference/4_objects/cms/0_languages/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $languages
+Name: Languages
 
 ----
 

content/docs/2_reference/4_objects/cms/0_layout/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $layout
+Name: Layout
 
 ----
 

content/docs/2_reference/4_objects/cms/0_layouts/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $layouts
+Name: Layouts
 
 ----
 

content/docs/2_reference/4_objects/cms/0_page/reference-class.txt

@@ -1,84 +1,84 @@
-Title: $page
-
-----
-
-Class: Kirby\Cms\Page
-
-----
-
-Text:
-
-You can extend this set of methods with (link: docs/reference/plugins/extensions/page-methods text: custom page methods) or in a (link: docs/reference/plugins/extensions/page-models text: page model).
-
-## How to fetch the `$page` object
-
-The `$page` class is available in Kirby's templates/snippets etc. through the `$page` variable that -  unless otherwise defined – always refers to the current page. However, you can also define a `$page` object by calling a specific page using the [`page()` helper](/docs/reference/templates/helpers/page):
-
-```php
-$page = page('somepage');
-```
-
-Or getting it from a collection of pages
-
-```php
-$page = $pages->first();
-```
-
-<info>
-When getting a specific page via the [`page()` helper](/docs/reference/templates/helpers/page) or when trying to create a page object from field values stored in content, always verify that you have a page object before you call any of the Page methods.
-</info>
-
-## Content fields
-
-The `$page` class offers a magic caller for your (link: docs/guide/content/fields text: content fields). Instead of getting them via e.g.
-
-```php
-$page->content()->get('your_field')
-```
-
-you can use the shorthand
-
-```php
-$page->your_field()
-```
-
-<info>
-You can not use the shorthand for fields with names that conflict with the default methods of the `$page` class (see above) or used by custom page methods.
-</info>
-
-
-## Examples
-
-With the `$page` object defined, you can start using the methods of the class:
-
-### Get a field of the page
-
-```php
-<?= $page->title() ?>
-```
-
-### Get the children of the page
-
-```php
-<?php $children = $page->children() ?>
-```
-
-### Get all images of the page
-
-```php
-<?php $images = $page->images() ?>
-```
-
-### Check if the page is active
-
-```php
-<?php e($page->isActive(), 'active') ?>
-```
-
-### Check if the page has draft children
-
-```php
-if ($page->hasDrafts()) {
-  echo "This page still has some children that haven't been published yet";
-}
-```
+Name: Page
+
+----
+
+Class: Kirby\Cms\Page
+
+----
+
+Text:
+
+You can extend this set of methods with (link: docs/reference/plugins/extensions/page-methods text: custom page methods) or in a (link: docs/reference/plugins/extensions/page-models text: page model).
+
+## How to fetch the `$page` object
+
+The `$page` class is available in Kirby's templates/snippets etc. through the `$page` variable that -  unless otherwise defined – always refers to the current page. However, you can also define a `$page` object by calling a specific page using the [`page()` helper](/docs/reference/templates/helpers/page):
+
+```php
+$page = page('somepage');
+```
+
+Or getting it from a collection of pages
+
+```php
+$page = $pages->first();
+```
+
+<info>
+When getting a specific page via the [`page()` helper](/docs/reference/templates/helpers/page) or when trying to create a page object from field values stored in content, always verify that you have a page object before you call any of the Page methods.
+</info>
+
+## Content fields
+
+The `$page` class offers a magic caller for your (link: docs/guide/content/fields text: content fields). Instead of getting them via e.g.
+
+```php
+$page->content()->get('your_field')
+```
+
+you can use the shorthand
+
+```php
+$page->your_field()
+```
+
+<info>
+You can not use the shorthand for fields with names that conflict with the default methods of the `$page` class (see above) or used by custom page methods.
+</info>
+
+
+## Examples
+
+With the `$page` object defined, you can start using the methods of the class:
+
+### Get a field of the page
+
+```php
+<?= $page->title() ?>
+```
+
+### Get the children of the page
+
+```php
+<?php $children = $page->children() ?>
+```
+
+### Get all images of the page
+
+```php
+<?php $images = $page->images() ?>
+```
+
+### Check if the page is active
+
+```php
+<?php e($page->isActive(), 'active') ?>
+```
+
+### Check if the page has draft children
+
+```php
+if ($page->hasDrafts()) {
+  echo "This page still has some children that haven't been published yet";
+}
+```

content/docs/2_reference/4_objects/cms/0_pages/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $pages
+Name: Pages
 
 ----
 

content/docs/2_reference/4_objects/cms/0_pagination/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $pagination
+Name: Pagination
 
 ----
 

content/docs/2_reference/4_objects/cms/0_responder/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $responder
+Name: Responder
 
 ----
 

content/docs/2_reference/4_objects/cms/0_site/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $site
+Name: Site
 
 ----
 

content/docs/2_reference/4_objects/cms/0_user/reference-class.txt

@@ -1,4 +1,4 @@
-Title: $user
+Name: User
 
 ----