From e002a2e954343db6f36ea805fb05b4e2983a6a0f Mon Sep 17 00:00:00 2001 From: Sebastian Meyer Date: Mon, 12 Feb 2024 18:38:42 +0100 Subject: [PATCH] Improve styling of documentation --- .phpdoc/template/components/sidebar.html.twig | 31 -------------- .phpdoc/template/css/custom.css.twig | 42 +++++++++++++++++-- ...asics-DataStructures-StrictCollection.html | 2 +- .../OCC-Basics-DataStructures-StrictList.html | 2 +- ...OCC-Basics-DataStructures-StrictQueue.html | 2 +- ...OCC-Basics-DataStructures-StrictStack.html | 2 +- ...ics-ErrorHandlers-ThrowErrorException.html | 2 +- ...s-ErrorHandlers-TriggerExceptionError.html | 2 +- ...CC-Basics-Interfaces-ArrayAccessTrait.html | 2 +- .../OCC-Basics-Interfaces-CountableTrait.html | 2 +- ...ics-Interfaces-IteratorAggregateTrait.html | 2 +- .../OCC-Basics-Interfaces-IteratorTrait.html | 2 +- doc/classes/OCC-Basics-Traits-Getter.html | 2 +- .../OCC-Basics-Traits-OverloadingGetter.html | 2 +- .../OCC-Basics-Traits-OverloadingSetter.html | 2 +- doc/classes/OCC-Basics-Traits-Setter.html | 2 +- doc/classes/OCC-Basics-Traits-Singleton.html | 2 +- doc/css/template.css | 42 +++++++++++++++++-- .../src-datastructures-strictcollection.html | 2 +- doc/files/src-datastructures-strictlist.html | 2 +- doc/files/src-datastructures-strictqueue.html | 2 +- doc/files/src-datastructures-strictstack.html | 2 +- ...src-errorhandlers-throwerrorexception.html | 2 +- ...c-errorhandlers-triggerexceptionerror.html | 2 +- .../src-interfaces-arrayaccesstrait.html | 2 +- doc/files/src-interfaces-countabletrait.html | 2 +- ...src-interfaces-iteratoraggregatetrait.html | 2 +- doc/files/src-interfaces-iteratortrait.html | 2 +- doc/files/src-traits-getter.html | 2 +- doc/files/src-traits-overloadinggetter.html | 2 +- doc/files/src-traits-overloadingsetter.html | 2 +- doc/files/src-traits-setter.html | 2 +- doc/files/src-traits-singleton.html | 2 +- doc/graphs/classes.html | 2 +- doc/guides/changelog/index.html | 2 +- doc/guides/index.html | 2 +- doc/guides/installation/index.html | 2 +- doc/guides/installation/test.html | 2 +- doc/index.html | 2 +- doc/indices/files.html | 2 +- doc/namespaces/default.html | 2 +- doc/namespaces/occ-basics-datastructures.html | 2 +- doc/namespaces/occ-basics-errorhandlers.html | 2 +- doc/namespaces/occ-basics-interfaces.html | 2 +- doc/namespaces/occ-basics-traits.html | 2 +- doc/namespaces/occ-basics.html | 2 +- doc/namespaces/occ.html | 2 +- doc/packages/Basics-DataStructures.html | 2 +- doc/packages/Basics-ErrorHandlers.html | 2 +- doc/packages/Basics-Interfaces.html | 2 +- doc/packages/Basics-Traits.html | 2 +- doc/packages/Basics.html | 2 +- doc/packages/default.html | 2 +- doc/reports/deprecated.html | 2 +- doc/reports/errors.html | 2 +- doc/reports/markers.html | 2 +- 56 files changed, 131 insertions(+), 90 deletions(-) delete mode 100644 .phpdoc/template/components/sidebar.html.twig diff --git a/.phpdoc/template/components/sidebar.html.twig b/.phpdoc/template/components/sidebar.html.twig deleted file mode 100644 index 7201879..0000000 --- a/.phpdoc/template/components/sidebar.html.twig +++ /dev/null @@ -1,31 +0,0 @@ - - - diff --git a/.phpdoc/template/css/custom.css.twig b/.phpdoc/template/css/custom.css.twig index 41e4fc2..bd6e01d 100644 --- a/.phpdoc/template/css/custom.css.twig +++ b/.phpdoc/template/css/custom.css.twig @@ -1,8 +1,11 @@ -.phpdocumentor-table-of-contents .phpdocumentor-table-of-contents__entry.-documentation:before { - content: 'D'; +aside.phpdocumentor-sidebar + h2.phpdocumentor-sidebar__category-header +{ + text-transform: capitalize; } -code.prettyprint { +code.prettyprint +{ background-color: var(--code-background-color); border: 1px solid #f0f0f0; border-radius: var(--border-radius-base-size); @@ -10,3 +13,36 @@ code.prettyprint { font-size: var(--text-sm); padding: var(--spacing-xxxs); } + +dl.phpdocumentor-table-of-contents + dt.phpdocumentor-table-of-contents__entry.-documentation:before +{ + content: 'D'; +} + +h2.phpdocumentor-content__title +{ + display: flex; + flex-direction: column; +} + +h2.phpdocumentor-content__title + div.phpdocumentor-element__package +{ + order: 1; +} + +h2.phpdocumentor-content__title + span.phpdocumentor-element__extends, +h2.phpdocumentor-content__title + span.phpdocumentor-element__implements +{ + font-size: calc(var(--text-xxs) / 1.2 / 1.2); + order: 2; +} + +h2.phpdocumentor-content__title + span:first-letter +{ + text-transform: lowercase; +} diff --git a/doc/classes/OCC-Basics-DataStructures-StrictCollection.html b/doc/classes/OCC-Basics-DataStructures-StrictCollection.html index bac59ef..276b8d0 100644 --- a/doc/classes/OCC-Basics-DataStructures-StrictCollection.html +++ b/doc/classes/OCC-Basics-DataStructures-StrictCollection.html @@ -72,7 +72,7 @@