angular/aio/tools/transforms/templates/api/includes/class-overview.html

{%- import "lib/memberHelpers.html" as memberHelper -%}
{%- import "lib/descendants.html" as descendants -%}

<section class="{$ doc.docType $}-overview">
<code-example language="ts" hideCopy="true">
{% if doc.isAbstract %}abstract {% endif%}class {$ doc.name $}{$ doc.typeParams | escape $}{$ memberHelper.renderHeritage(doc) $} {{$ memberHelper.renderMembers(doc) $}
}
</code-example>
{$ descendants.renderDescendants(doc, 'class', 'Subclasses', true, r/class|directive|pipe|decorator/) $}
</section>
perf(docs-infra): reduce unnecessary whitespace in API docs (#43435) The HTML for the docs pages is generated by Dgeni based on some [Nunjucks][1] templates. Previously, these templates were set up in a way that introduced a lot excess whitespace in the generated HTML, unnecessarily bloating the corresponding JSON files that need to be downloaded in order to view a certain docs page. This has been discussed in #28105 and was again observed while investigating #43285. This commit refactors some of the templates related to API docs (which seem to be the most affected ones) to drastically reduce the amount of excess whitespace. More specifically, the total size of all files in `generated/docs/api/` was reduced from ~13MB to ~7MB. Besides the reduced payload size for each API page, this change will also reduce the amount of memory needed by the ServiceWorker to cache the API pages that have been visited by a user. NOTE: The affected files are not eagerly downloaded when navigating to angular.io. Instead, each file is downloaded individually, as soon as a user visits the corresponding API docs page. Therefore, the impact of this change will be relatively small for most users. [1]: https://mozilla.github.io/nunjucks/ PR Close #43435 2021-09-14 10:59:19 +00:00			`{%- import "lib/memberHelpers.html" as memberHelper -%}`
			`{%- import "lib/descendants.html" as descendants -%}`
build(aio): refactor API templates for clean start 2017-05-02 14:08:49 +00:00
build(aio): update doc-gen templates 2017-06-29 21:23:27 +00:00			`<section class="{$ doc.docType $}-overview">`
refactor(docs-infra): remove `linenums=false` since it is now the default (#31674) PR Close #31674 2019-07-20 17:40:17 +00:00			`<code-example language="ts" hideCopy="true">`
build(docs-infra): separate NgModules from Classes in API docs (#25734) PR Close #25734 2018-08-29 16:23:08 +00:00			`{% if doc.isAbstract %}abstract {% endif%}class {$ doc.name $}{$ doc.typeParams \| escape $}{$ memberHelper.renderHeritage(doc) $} {{$ memberHelper.renderMembers(doc) $}`
build(aio): truncate API overview parameters at one line 2017-07-13 12:33:48 +00:00			`}`
			`</code-example>`
build(docs-infra): include directives etc in class descendants lists (#25768) PR Close #25768 2018-09-20 11:58:10 +00:00			`{$ descendants.renderDescendants(doc, 'class', 'Subclasses', true, r/class\|directive\|pipe\|decorator/) $}`
build(aio): update doc-gen templates 2017-06-29 21:23:27 +00:00			`</section>`