NoBey/openzeppelin-contracts
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Design tweaks to documentation template (#1937)

Browse Source 
* switch index to show arg names

* add index separators

* add classes to style variable type and name

* add class for inherited part of index

* use inheritedItems in contracts template

* refactor template to use explicit if and each

(cherry picked from commit 5d6a040fc3)
This commit is contained in:
Francisco Giordano
2019-10-17 18:42:31 -03:00
parent f5fe378cc6
commit 9df4f7971e
1 changed files with 51 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

77
docs/contract.hbs
View File

@ -1,6 +1,10 @@
{{#linkable}}
{{~#*inline "typed-variable-array"~}}
{{#each .}}[.var-type\]#{{typeName}}#{{#if name}} [.var-name\]#{{name}}#{{/if}}{{#unless @last}}, {{/unless}}{{/each}}
{{~/inline~}}
{{#each linkable}}
:{{name}}: pass:normal[xref:#{{anchor}}[`{{name}}`]]
{{/linkable}}
{{/each}}
[.contract]
[[{{anchor}}]]
@ -11,56 +15,77 @@
{{#if modifiers}}
[.contract-index]
.Modifiers
{{#inheritance}}
{{#ownModifiers}}
* xref:#{{anchor}}[`{{signature}}`]
{{/ownModifiers}}
{{/inheritance}}
--
{{#each inheritedItems}}
{{#unless @first}}
[.contract-subindex-inherited]
.{{contract.name}}
{{/unless}}
{{#each modifiers}}
* xref:#{{anchor}}[`{{name}}({{args.names}})`]
{{/each}}
{{/each}}
--
{{/if}}
{{#if functions}}
[.contract-index]
.Functions
{{#inheritance}}
{{#ownFunctions}}
* xref:#{{anchor}}[`{{signature}}`]
{{/ownFunctions}}
{{/inheritance}}
--
{{#each inheritedItems}}
{{#unless @first}}
[.contract-subindex-inherited]
.{{contract.name}}
{{/unless}}
{{#each functions}}
* xref:#{{anchor}}[`{{name}}({{args.names}})`]
{{/each}}
{{/each}}
--
{{/if}}
{{#if events}}
[.contract-index]
.Events
{{#inheritance}}
{{#ownEvents}}
* xref:#{{anchor}}[`{{signature}}`]
{{/ownEvents}}
{{/inheritance}}
--
{{#each inheritedItems}}
{{#unless @first}}
[.contract-subindex-inherited]
.{{contract.name}}
{{/unless}}
{{#each events}}
* xref:#{{anchor}}[`{{name}}({{args.names}})`]
{{/each}}
{{/each}}
--
{{/if}}
{{#ownModifiers}}
{{#each modifiers}}
[.contract-item]
[[{{anchor}}]]
==== `{{name}}({{args}})`
==== `pass:normal[{{name}}({{> typed-variable-array args}})]`
{{natspec.devdoc}}
{{/ownModifiers}}
{{/each}}
{{#ownFunctions}}
{{#each functions}}
[.contract-item]
[[{{anchor}}]]
==== `{{name}}({{args}}){{#if outputs}} → {{outputs}}{{/if}}` [.visibility]#{{visibility}}#
==== `pass:normal[{{name}}({{> typed-variable-array args}}){{#if outputs}} → {{> typed-variable-array outputs}}{{/if}}]` [.visibility]#{{visibility}}#
{{natspec.devdoc}}
{{/ownFunctions}}
{{/each}}
{{#ownEvents}}
{{#each events}}
[.contract-item]
[[{{anchor}}]]
==== `{{name}}({{args}})`
==== `pass:normal[{{name}}({{> typed-variable-array args}})]`
{{natspec.devdoc}}
{{/ownEvents}}
{{/each}}