Browse Source

Removed node.js docs, as this corresponds to gh-pages

sisyphus
JezerM 4 years ago
parent
commit
af762ce347
  1. 3
      docs/.gitignore
  2. 4
      docs/Greeter.js
  3. 0
      docs/GreeterConfig.js
  4. 0
      docs/LightDMObjects.js
  5. 0
      docs/ThemeUtils.js
  6. 3
      docs/book.json
  7. 20
      docs/docs/README.md
  8. 18
      docs/docs/SUMMARY.md
  9. 23
      docs/docs/api/Battery.md
  10. 338
      docs/docs/api/Greeter.md
  11. 55
      docs/docs/api/GreeterConfig.md
  12. 24
      docs/docs/api/Language.md
  13. 24
      docs/docs/api/Layout.md
  14. 6
      docs/docs/api/LightDM.md
  15. 24
      docs/docs/api/Session.md
  16. 26
      docs/docs/api/Signal.md
  17. 47
      docs/docs/api/ThemeUtils.md
  18. 54
      docs/docs/api/User.md
  19. 51
      docs/docs/howto/intro.md
  20. 43
      docs/index.js
  21. 17
      docs/jsdoc.json
  22. 19
      docs/manual/Battery.md
  23. 297
      docs/manual/Greeter.md
  24. 53
      docs/manual/GreeterConfig.md
  25. 18
      docs/manual/Language.md
  26. 18
      docs/manual/Layout.md
  27. 23
      docs/manual/Session.md
  28. 39
      docs/manual/ThemeUtils.md
  29. 43
      docs/manual/User.md
  30. 7496
      docs/package-lock.json
  31. 22
      docs/package.json
  32. 3
      docs/templates/partials/all-docs/all-docs.hbs
  33. 2
      docs/templates/partials/all-docs/docs/body/access.hbs
  34. 2
      docs/templates/partials/all-docs/docs/body/augments.hbs
  35. 2
      docs/templates/partials/all-docs/docs/body/authors.hbs
  36. 29
      docs/templates/partials/all-docs/docs/body/body.hbs
  37. 2
      docs/templates/partials/all-docs/docs/body/category.hbs
  38. 2
      docs/templates/partials/all-docs/docs/body/chainable.hbs
  39. 2
      docs/templates/partials/all-docs/docs/body/copyright.hbs
  40. 3
      docs/templates/partials/all-docs/docs/body/customTags.hbs
  41. 2
      docs/templates/partials/all-docs/docs/body/default.hbs
  42. 3
      docs/templates/partials/all-docs/docs/body/deprecated.hbs
  43. 3
      docs/templates/partials/all-docs/docs/body/description.hbs
  44. 4
      docs/templates/partials/all-docs/docs/body/examples.hbs
  45. 3
      docs/templates/partials/all-docs/docs/body/fires.hbs
  46. 2
      docs/templates/partials/all-docs/docs/body/implements.hbs
  47. 2
      docs/templates/partials/all-docs/docs/body/license.hbs
  48. 3
      docs/templates/partials/all-docs/docs/body/mixes.hbs
  49. 2
      docs/templates/partials/all-docs/docs/body/overrides.hbs
  50. 4
      docs/templates/partials/all-docs/docs/body/params/param-table-name.hbs
  51. 9
      docs/templates/partials/all-docs/docs/body/params/params-list.hbs
  52. 20
      docs/templates/partials/all-docs/docs/body/params/params-table-html.hbs
  53. 12
      docs/templates/partials/all-docs/docs/body/params/params-table.hbs
  54. 4
      docs/templates/partials/all-docs/docs/body/params/params.hbs
  55. 7
      docs/templates/partials/all-docs/docs/body/properties/properties-list.hbs
  56. 21
      docs/templates/partials/all-docs/docs/body/properties/properties-table-html.hbs
  57. 12
      docs/templates/partials/all-docs/docs/body/properties/properties-table.hbs
  58. 4
      docs/templates/partials/all-docs/docs/body/properties/properties.hbs
  59. 2
      docs/templates/partials/all-docs/docs/body/readOnly.hbs
  60. 3
      docs/templates/partials/all-docs/docs/body/requires.hbs
  61. 12
      docs/templates/partials/all-docs/docs/body/returns.hbs
  62. 10
      docs/templates/partials/all-docs/docs/body/scope.hbs
  63. 12
      docs/templates/partials/all-docs/docs/body/see.hbs
  64. 2
      docs/templates/partials/all-docs/docs/body/since.hbs
  65. 2
      docs/templates/partials/all-docs/docs/body/summary.hbs
  66. 2
      docs/templates/partials/all-docs/docs/body/this.hbs
  67. 8
      docs/templates/partials/all-docs/docs/body/throws.hbs
  68. 22
      docs/templates/partials/all-docs/docs/body/todo.hbs
  69. 2
      docs/templates/partials/all-docs/docs/body/version.hbs
  70. 5
      docs/templates/partials/all-docs/docs/docs.hbs
  71. 3
      docs/templates/partials/all-docs/docs/header.hbs
  72. 4
      docs/templates/partials/all-docs/docs/member-index/member-index-grouped.hbs
  73. 4
      docs/templates/partials/all-docs/docs/member-index/member-index-list.hbs
  74. 26
      docs/templates/partials/all-docs/docs/member-index/member-index.hbs
  75. 3
      docs/templates/partials/all-docs/docs/members.hbs
  76. 11
      docs/templates/partials/main-index/global-index/global-index-dl.hbs
  77. 9
      docs/templates/partials/main-index/global-index/global-index-grouped.hbs
  78. 11
      docs/templates/partials/main-index/global-index/global-index-kinds.hbs
  79. 22
      docs/templates/partials/main-index/global-index/global-index-table.hbs
  80. 10
      docs/templates/partials/main-index/global-index/global-index.hbs
  81. 6
      docs/templates/partials/main-index/main-index.hbs
  82. 11
      docs/templates/partials/main-index/module-index/module-index-dl.hbs
  83. 7
      docs/templates/partials/main-index/module-index/module-index-grouped.hbs
  84. 22
      docs/templates/partials/main-index/module-index/module-index-table.hbs
  85. 5
      docs/templates/partials/main-index/module-index/module-index.hbs
  86. 2
      docs/templates/partials/main.hbs
  87. 1
      docs/templates/partials/shared/heading-indent.hbs
  88. 1
      docs/templates/partials/shared/index-indent.hbs
  89. 5
      docs/templates/partials/shared/separator.hbs
  90. 14
      docs/templates/partials/shared/signature/sig-link-html.hbs
  91. 13
      docs/templates/partials/shared/signature/sig-link-parent.hbs
  92. 14
      docs/templates/partials/shared/signature/sig-link.hbs
  93. 15
      docs/templates/partials/shared/signature/sig-name.hbs
  94. 1
      docs/templates/partials/shared/value/defaultvalue.hbs
  95. 25
      docs/templates/partials/shared/value/link.hbs
  96. 4
      docs/templates/partials/shared/value/linked-type-list.hbs

3
docs/.gitignore vendored

@ -1,3 +0,0 @@
node_modules/
package-lock.json
_book/

4
docs/src/Greeter.js → docs/Greeter.js vendored

@ -176,7 +176,7 @@ class Greeter {
/**
* The current language or {@link null} if no language.
* @type {Language|null}
* @type {Language|Null}
* @readonly
*/
get language() {}
@ -258,7 +258,7 @@ class Greeter {
/**
* Starts the authentication procedure for a user.
*
* @param {String|null} username A username or {@link null} to prompt for a username.
* @param {String|Null} username A username or {@link null} to prompt for a username.
*/
authenticate( username ) {}

0
docs/src/GreeterConfig.js → docs/GreeterConfig.js vendored

0
docs/src/LightDMObjects.js → docs/LightDMObjects.js vendored

0
docs/src/ThemeUtils.js → docs/ThemeUtils.js vendored

3
docs/book.json vendored

@ -1,3 +0,0 @@
{
"root": "docs/"
}

20
docs/docs/README.md vendored

@ -1,20 +0,0 @@
# Web Greeter for LightDM
A modern, visually appealing greeter for LightDM, that allows to create web based themes with HTML, CSS and JavaScript.
This is a try to update the [Antergos web-greeter](https://github.com/Antergos/web-greeter), following what they left.
## Features
- Create themes with HTML, CSS and JavaScript!
- Should work everywhere.
- JavaScript error handling, allowing to load the default theme.
- Themes could be simple, or very complex.
- Battery and brightness control.
## Theme JavaScript API
See the [JavaScript API][jsAPI] here, and some [HOWTO][howto] here too!
[jsAPI]: ./api/LightDM.md
[howto]: ./howto

18
docs/docs/SUMMARY.md vendored

@ -1,18 +0,0 @@
# Summary
* [Introduction](README.md)
## Javascript API
* [LightDM](api/LightDM.md)
* [Greeter](api/Greeter.md)
* [GreeterConfig](api/GreeterConfig.md)
* [ThemeUtils](api/ThemeUtils.md)
* [Battery](api/Battery.md)
* [Language](api/Language.md)
* [Layout](api/Layout.md)
* [Session](api/Session.md)
* [User](api/User.md)
* [Signal](api/Signal.md)
## HOWTO
* [Introduction](howto/intro.md)

23
docs/docs/api/Battery.md vendored

@ -1,23 +0,0 @@
<a id="LightDM.Battery"></a>
## LightDM.Battery
Interface for object that holds info about the battery on the system. This object is not created by the theme's code, but rather by the [`LightDM.Greeter`](Greeter.md) class.
<a id="LightDM.Battery+level"></a>
### battery.level : <code>String</code> \| <code>Null</code>
The battery level.
**Read only**: true
<a id="LightDM.Battery+name"></a>
### battery.name : <code>String</code> \| <code>Null</code>
The battery's name.
**Read only**: true
<a id="LightDM.Battery+state"></a>
### battery.state : <code>String</code> \| <code>Null</code>
The state for the battery
**Read only**: true

338
docs/docs/api/Greeter.md vendored

@ -1,338 +0,0 @@
<a id="LightDM.Greeter"></a>
## LightDM.Greeter
Base class for the greeter's Theme JavaScript API. Greeter themes will interact
directly with an object derived from this class to facilitate the user log-in process.
The greeter will automatically create an instance when it starts.
The instance can be accessed using the global variable: `lightdm`.
<a id="LightDM.Greeter+authentication_user"></a>
### greeter.authentication\_user : <code>String</code> \| <code>Null</code>
The username of the user being authenticated or [null](null)
if no authentication is in progress
**Read only**: true
<a id="LightDM.Greeter+autologin_guest"></a>
### greeter.autologin\_guest : <code>Boolean</code>
Whether or not the guest account should be automatically logged
into when the timer expires.
**Read only**: true
<a id="LightDM.Greeter+autologin_timeout"></a>
### greeter.autologin\_timeout : <code>Number</code>
The number of seconds to wait before automatically logging in.
**Read only**: true
<a id="LightDM.Greeter+autologin_user"></a>
### greeter.autologin\_user : <code>String</code>
The username with which to automattically log in when the timer expires.
**Read only**: true
<a id="LightDM.Greeter+batteryData"></a>
### greeter.batteryData : <code>Battery</code>
The battery data
**Read only**: true
<a id="LightDM.Greeter+brightness"></a>
### greeter.brightness : <code>Number</code>
The display brightness
<a id="LightDM.Greeter+can_access_battery"></a>
### greeter.can\_access\_battery : <code>boolean</code>
Whether or not the greeter can access to battery data.
**Read only**: true
<a id="LightDM.Greeter+can_access_brightness"></a>
### greeter.can\_access\_brightness : <code>boolean</code>
Whether or not the greeter can control display brightness.
**Read only**: true
<a id="LightDM.Greeter+can_hibernate"></a>
### greeter.can\_hibernate : <code>Boolean</code>
Whether or not the greeter can make the system hibernate.
**Read only**: true
<a id="LightDM.Greeter+can_restart"></a>
### greeter.can\_restart : <code>Boolean</code>
Whether or not the greeter can make the system restart.
**Read only**: true
<a id="LightDM.Greeter+can_shutdown"></a>
### greeter.can\_shutdown : <code>Boolean</code>
Whether or not the greeter can make the system shutdown.
**Read only**: true
<a id="LightDM.Greeter+can_suspend"></a>
### greeter.can\_suspend : <code>Boolean</code>
Whether or not the greeter can make the system suspend/sleep.
**Read only**: true
<a id="LightDM.Greeter+default_session"></a>
### greeter.default\_session : <code>String</code>
The name of the default session.
**Read only**: true
<a id="LightDM.Greeter+has_guest_account"></a>
### greeter.has\_guest\_account : <code>Boolean</code>
Whether or not guest sessions are supported.
**Read only**: true
<a id="LightDM.Greeter+hide_users_hint"></a>
### greeter.hide\_users\_hint : <code>boolean</code>
Whether or not user accounts should be hidden.
**Read only**: true
<a id="LightDM.Greeter+hostname"></a>
### greeter.hostname : <code>String</code>
The system's hostname.
**Read only**: true
<a id="LightDM.Greeter+in_authentication"></a>
### greeter.in\_authentication : <code>Boolean</code>
Whether or not the greeter is in the process of authenticating.
**Read only**: true
<a id="LightDM.Greeter+is_authenticated"></a>
### greeter.is\_authenticated : <code>Boolean</code>
Whether or not the greeter has successfully authenticated.
**Read only**: true
<a id="LightDM.Greeter+language"></a>
### greeter.language : <code>Language</code> \| <code>null</code>
The current language or [null](null) if no language.
**Read only**: true
<a id="LightDM.Greeter+languages"></a>
### greeter.languages : <code>Array.&lt;Language&gt;</code>
A list of languages to present to the user.
**Read only**: true
<a id="LightDM.Greeter+layout"></a>
### greeter.layout : <code>Layout</code>
The currently active layout for the selected user.
<a id="LightDM.Greeter+layouts"></a>
### greeter.layouts : <code>Array.&lt;Layout&gt;</code>
A list of keyboard layouts to present to the user.
**Read only**: true
<a id="LightDM.Greeter+lock_hint"></a>
### greeter.lock\_hint : <code>Boolean</code>
Whether or not the greeter was started as a lock screen.
**Read only**: true
<a id="LightDM.Greeter+select_guest_hint"></a>
### greeter.select\_guest\_hint : <code>Boolean</code>
Whether or not the guest account should be selected by default.
**Read only**: true
<a id="LightDM.Greeter+select_user_hint"></a>
### greeter.select\_user\_hint : <code>String</code>
The username to select by default.
**Read only**: true
<a id="LightDM.Greeter+sessions"></a>
### greeter.sessions : <code>Array.&lt;Session&gt;</code>
List of available sessions.
**Read only**: true
<a id="LightDM.Greeter+show_manual_login_hint"></a>
### greeter.show\_manual\_login\_hint : <code>Boolean</code>
Check if a manual login option should be shown. If [true](true), the theme should
provide a way for a username to be entered manually. Otherwise, themes that show
a user list may limit logins to only those users.
**Read only**: true
<a id="LightDM.Greeter+show_remote_login_hint"></a>
### greeter.show\_remote\_login\_hint : <code>Boolean</code>
Check if a remote login option should be shown. If [true](true), the theme should provide
a way for a user to log into a remote desktop server.
**Read only**: true
**Internal**:
<a id="LightDM.Greeter+users"></a>
### greeter.users : <code>Array.&lt;User&gt;</code>
List of available users.
**Read only**: true
<a id="LightDM.Greeter+authentication_complete"></a>
### greeter.authentication\_complete : <code>Signal</code>
Gets emitted when the greeter has completed authentication.
<a id="LightDM.Greeter+autologin_timer_expired"></a>
### greeter.autologin\_timer\_expired : <code>Signal</code>
Gets emitted when the automatic login timer has expired.
<a id="LightDM.Greeter+brightness_update"></a>
### greeter.brightness\_update : <code>Signal</code>
Gets emitted when brightness is updated
<a id="LightDM.Greeter+idle"></a>
### greeter.idle : <code>Signal</code>
Gets emitted when the user has logged in and the greeter is no longer needed.
<a id="LightDM.Greeter+reset"></a>
### greeter.reset : <code>Signal</code>
Gets emitted when the user is returning to a greeter that
was previously marked idle.
<a id="LightDM.Greeter+show_message"></a>
### greeter.show\_message : <code>Signal</code>
Gets emitted when the greeter should show a message to the user.
<a id="LightDM.Greeter+show_prompt"></a>
### greeter.show\_prompt : <code>Signal</code>
Gets emitted when the greeter should show a prompt to the user.
<a name="LightDM.Greeter+authenticate"></a>
### greeter.authenticate(username)
Starts the authentication procedure for a user.
| Param | Type | Description |
| --- | --- | --- |
| username | <code>String</code> \| <code>null</code> | A username or [null](null) to prompt for a username. |
<a id="LightDM.Greeter+authenticate_as_guest"></a>
### greeter.authenticate\_as\_guest()
Starts the authentication procedure for the guest user.
<a id="LightDM.Greeter+batteryUpdate"></a>
### greeter.batteryUpdate()
Updates the battery data
<a id="LightDM.Greeter+brightnessSet"></a>
### greeter.brightnessSet(quantity)
Set the brightness to quantity
| Param | Type | Description |
| --- | --- | --- |
| quantity | <code>Number</code> | The quantity to set |
<a id="LightDM.Greeter+brightnessIncrease"></a>
### greeter.brightnessIncrease(quantity)
Increase the brightness by quantity
| Param | Type | Description |
| --- | --- | --- |
| quantity | <code>Number</code> | The quantity to increase |
<a id="LightDM.Greeter+brightnessDecrease"></a>
### greeter.brightnessDecrease(quantity)
Decrease the brightness by quantity
| Param | Type | Description |
| --- | --- | --- |
| quantity | <code>Number</code> | The quantity to decrease |
<a id="LightDM.Greeter+cancel_authentication"></a>
### greeter.cancel\_authentication()
Cancel user authentication that is currently in progress.
<a id="LightDM.Greeter+cancel_autologin"></a>
### greeter.cancel\_autologin()
Cancel the automatic login.
<a id="LightDM.Greeter+hibernate"></a>
### greeter.hibernate() ⇒ <code>Boolean</code>
Triggers the system to hibernate.
**Returns**: <code>Boolean</code> - [true](true) if hibernation initiated, otherwise [false](false)
<a id="LightDM.Greeter+respond"></a>
### greeter.respond(response)
Provide a response to a prompt.
| Param | Type |
| --- | --- |
| response | <code>\*</code> |
<a id="LightDM.Greeter+restart"></a>
### greeter.restart() ⇒ <code>Boolean</code>
Triggers the system to restart.
**Returns**: <code>Boolean</code> - [true](true) if restart initiated, otherwise [false](false)
<a id="LightDM.Greeter+set_language"></a>
### greeter.set\_language(language) ⇒ <code>Boolean</code>
Set the language for the currently authenticated user.
**Returns**: <code>Boolean</code> - [true](true) if successful, otherwise [false](false)
| Param | Type | Description |
| --- | --- | --- |
| language | <code>String</code> | The language in the form of a locale specification (e.g. 'de_DE.UTF-8') |
<a id="LightDM.Greeter+shutdown"></a>
### greeter.shutdown() ⇒ <code>Boolean</code>
Triggers the system to shutdown.
**Returns**: <code>Boolean</code> - [true](true) if shutdown initiated, otherwise [false](false)
<a id="LightDM.Greeter+start_session"></a>
### greeter.start\_session(session) ⇒ <code>Boolean</code>
Start a session for the authenticated user.
**Returns**: <code>Boolean</code> - [true](true) if successful, otherwise [false](false)
| Param | Type | Description |
| --- | --- | --- |
| session | <code>String</code> \| <code>null</code> | The session to log into or [null](null) to use the default. |
<a id="LightDM.Greeter+suspend"></a>
### greeter.suspend() ⇒ <code>Boolean</code>
Triggers the system to suspend/sleep.
**Returns**: <code>Boolean</code> - [true](true) if suspend/sleep initiated, otherwise [false](false)

55
docs/docs/api/GreeterConfig.md vendored

@ -1,55 +0,0 @@
<a id="LightDM.GreeterConfig"></a>
## LightDM.GreeterConfig
Provides greeter themes with a way to access values from the greeter's config
file located at `/etc/lightdm/web-greeter.yml`. The greeter will
create an instance of this class when it starts. The instance can be accessed
with the global variable: `greeter_config`.
<a id="LightDM.GreeterConfig+branding"></a>
### greeterConfig.branding : <code>object</code>
Holds keys/values from the `branding` section of the config file.
**Read only**: true
**Properties**
| Name | Type | Description |
| --- | --- | --- |
| background_images_dir | <code>string</code> | Path to directory that contains background images for use in greeter themes. |
| logo | <code>string</code> | Path to distro logo image for use in greeter themes. |
| user_image | <code>string</code> | Default user image/avatar. This is used by greeter themes for users that have not configured a `.face` image. |
<a id="LightDM.GreeterConfig+greeter"></a>
### greeterConfig.greeter : <code>object</code>
Holds keys/values from the `greeter` section of the config file.
**Read only**: true
**Properties**
| Name | Type | Description |
| --- | --- | --- |
| debug_mode | <code>boolean</code> | Greeter theme debug mode. |
| detect_theme_errors | <code>boolean</code> | Provide an option to load a fallback theme when theme errors are detected. |
| screensaver_timeout | <code>number</code> | Blank the screen after this many seconds of inactivity. |
| secure_mode | <code>boolean</code> | Don't allow themes to make remote http requests. |
| time_format | <code>string</code> | A moment.js format string to be used by the greeter to generate localized time for display. |
| time_language | <code>string</code> | Language to use when displaying the time or `auto` to use the system's language. |
| theme | <code>string</code> | The name of the theme to be used by the greeter. |
<a id="LightDM.GreeterConfig+features"></a>
### greeterConfig.features : <code>Object</code>
Holds keys/values from the `features` section of the config file.
**Properties**
| Name | Type | Description |
| --- | --- | --- |
| battery | <code>Boolean</code> | Enable greeter and themes to ger battery status. |
| backlight | <code>Object</code> | |
| backlight.enabled | <code>Boolean</code> | Enable greeter and themes to control display backlight. |
| backlight.value | <code>Number</code> | The amount to increase/decrease brightness by greeter. |
| backlight.steps | <code>Number</code> | How many steps are needed to do the change. |

24
docs/docs/api/Language.md vendored

@ -1,24 +0,0 @@
<a id="LightDM.Language"></a>
## LightDM.Language
Interface for object that holds info about a language on the system. Language objects are not
created by the theme's code, but rather by the [`LightDM.Greeter`](Greeter.md) class.
<a id="LightDM.Language+code"></a>
### language.code : <code>String</code>
The code for the language.
**Read only**: true
<a id="LightDM.Language+name"></a>
### language.name : <code>String</code>
The name for the layout.
**Read only**: true
<a id="LightDM.Language+territory"></a>
### language.territory : <code>String</code>
The territory for the language.
**Read only**: true

24
docs/docs/api/Layout.md vendored

@ -1,24 +0,0 @@
<a id="LightDM.Layout"></a>
## LightDM.Layout
Interface for object that holds info about a keyboard layout on the system. Language
objects are not created by the theme's code, but rather by the [`LightDM.Greeter`](Greeter.md) class.
<a id="LightDM.Layout+description"></a>
### layout.description : <code>String</code>
The description for the layout.
**Read only**: true
<a id="LightDM.Layout+name"></a>
### layout.name : <code>String</code>
The name for the layout.
**Read only**: true
<a id="LightDM.Layout+short_description"></a>
### layout.short\_description : <code>String</code>
The territory for the layout.
**Read only**: true

6
docs/docs/api/LightDM.md vendored

@ -1,6 +0,0 @@
<a id="LightDM"></a>
## LightDM : <code>object</code>
The greeter's Theme JavaScript API.
Accesible through `lightdm` global variable.

24
docs/docs/api/Session.md vendored

@ -1,24 +0,0 @@
<a id="LightDM.Session"></a>
## LightDM.Session
Interface for object that holds info about a session. Session objects are not
created by the theme's code, but rather by the [`LightDM.Greeter`](Greeter.md) class.
<a id="LightDM.Session+name"></a>
### session.name : <code>String</code>
The name for the session.
**Read only**: true
<a id="LightDM.Session+key"></a>
### session.key : <code>String</code>
The key for the session.
**Read only**: true
<a id="LightDM.Session+comment"></a>
### session.comment : <code>String</code>
The comment for the session.
**Read only**: true

26
docs/docs/api/Signal.md vendored

@ -1,26 +0,0 @@
<a id="LightDM.Signal"></a>
## LightDM.Signal
Interface for signals connected to LightDM itself. This is not created by the theme's code, but rather by Web Greeter.
When Web Greeter triggers the signal, all calbacks are executed.
<a id="LightDM.Signal+connect"></a>
### signal.connect(callback)
Connects a callback to the signal.
| Param | Type | Description |
| --- | --- | --- |
| callback | <code>function</code> | The callback to attach. |
<a id="LightDM.Signal+disconnect"></a>
### signal.disconnect(callback)
Disconnects a callback to the signal.
| Param | Type | Description |
| --- | --- | --- |
| callback | <code>function</code> | The callback to disattach. |

47
docs/docs/api/ThemeUtils.md vendored

@ -1,47 +0,0 @@
<a id="LightDM.ThemeUtils"></a>
## LightDM.ThemeUtils
Provides various utility methods for use in greeter themes. The greeter will automatically
create an instance of this class when it starts. The instance can be accessed
with the global variable: `theme_utils`.
<a id="LightDM.ThemeUtils+bind_this"></a>
### themeUtils.bind\_this(context) ⇒ <code>Object</code>
Binds `this` to class, `context`, for all of the class's methods.
**Returns**: <code>Object</code> - `context` with `this` bound to it for all of its methods.
| Param | Type | Description |
| --- | --- | --- |
| context | <code>Object</code> | An ES6 class instance with at least one method. |
<a id="LightDM.ThemeUtils+dirlist"></a>
### themeUtils.dirlist(path, only_images, callback)
Returns the contents of directory found at `path` provided that the (normalized) `path`
meets at least one of the following conditions:
* Is located within the greeter themes' root directory.
* Has been explicitly allowed in the greeter's config file.
* Is located within the greeter's shared data directory (`/var/lib/lightdm-data`).
* Is located in `/tmp`.
| Param | Type | Default | Description |
| --- | --- | --- | --- |
| path | <code>String</code> | | The abs path to desired directory. |
| only_images | <code>Boolean</code> | <code>true</code> | Include only images in the results. Default `true`. |
| callback | <code>function</code> | | Callback function to be called with the result. |
<a id="LightDM.ThemeUtils+get_current_localized_time"></a>
### themeUtils.get\_current\_localized\_time() ⇒ <code>String</code>
Get the current time in a localized format. Time format and language are auto-detected
by default, but can be set manually in the greeter config file.
* `language` defaults to the system's language, but can be set manually in the config file.
* When `time_format` config file option has a valid value, time will be formatted
according to that value.
* When `time_format` does not have a valid value, the time format will be `LT`
which is `1:00 PM` or `13:00` depending on the system's locale.
**Returns**: <code>String</code> - The current localized time.

54
docs/docs/api/User.md vendored

@ -1,54 +0,0 @@
<a id="LightDM.User"></a>
## LightDM.User
Interface for object that holds info about a user account on the system. User
objects are not created by the theme's code, but rather by the [`LightDM.Greeter`](Greeter.md) class.
<a id="LightDM.User+display_name"></a>
### user.display\_name : <code>String</code>
The display name for the user.
**Read only**: true
<a id="LightDM.User+language"></a>
### user.language : <code>String</code>
The language for the user.
**Read only**: true
<a id="LightDM.User+layout"></a>
### user.layout : <code>String</code>
The keyboard layout for the user.
**Read only**: true
<a id="LightDM.User+image"></a>
### user.image : <code>String</code>
The image for the user.
**Read only**: true
<a id="LightDM.User+home_directory"></a>
### user.home\_directory : <code>String</code>
The home_directory for the user.
**Read only**: true
<a id="LightDM.User+username"></a>
### user.username : <code>String</code>
The username for the user.
**Read only**: true
<a id="LightDM.User+logged_in"></a>
### user.logged\_in : <code>Boolean</code>
Whether or not the user is currently logged in.
**Read only**: true
<a id="LightDM.User+session"></a>
### user.session : <code>String</code> \| <code>Null</code>
The last session that the user logged into.
**Read only**: true

51
docs/docs/howto/intro.md vendored

@ -1,51 +0,0 @@
# Introduction
Web Greeter has a simple API, documented here, which allows to communicate to the Web Greeter itself and the LightDM API.
To create a theme, you will need these essential functions:
```javascript
lightdm.authenticate(username)
lightdm.respond(response)
lightdm.start_session(session)
```
### [lightdm.authenticate(username)](/api/Greeter.md#LightDM.Greeter+authenticate)
This method starts the authentication procedure for a user, allowing to start the user session.
### lightdm.respond(response)
Provide a response to a prompt. Basically, this acts like a password provider. After the authentication is initiated, you need to provide the user password with this method. It could be "12345", "password", "strongpassword", y'know, a password.
> NOTE: If authentication is not initiated, this will cause an error.
### lightdm.start_session(session)
Starts a session for the authenticated user. After the user is authenticated, you will need to start the session with this method.
> NOTE: If user is not authenticated, this won't work.
And that's it. You can create a simple javascript file with this:
```javascript
lightdm.authenticate("superuser")
lightdm.respond("superpassword")
lightdm.start_session("ubuntu")
```
Although, if this could really work, it won't at first. The `lightdm` object is not available when the greeter is initiated, it is after a little delay. To make this work, an event is triggered when the API is ready to be used. Add an event listener to the `GreeterReady` event.
```javascript
window.addEventListener("GreeterReady", initGreeter)
```
And so, it will look like this:
```javascript
function initGreeter() {
lightdm.authenticate("superuser")
lightdm.respond("superpassword")
lightdm.start_session("ubuntu")
}
window.addEventListener("GreeterReady", initGreeter)
```

43
docs/index.js vendored

@ -1,43 +0,0 @@
'use strict'
const jsdoc2md = require("jsdoc-to-markdown")
const fs = require('fs')
const path = require('path')
const outputDir = "./docs/api/"
function generateFiles(file) {
const templateData = jsdoc2md.getTemplateDataSync({
files: file,
//configure: "./jsdoc.json"
})
let selectedData = templateData.reduce( (selectedData, identifier) => {
if (identifier.kind == 'class' || identifier.kind == 'namespace') {
selectedData.push(identifier)
}
return selectedData
}, [])
for (const identifier of selectedData) {
let template = ""
let name = identifier.name
if (identifier.kind == 'class') {
template = `{{#class name="${name}"}}{{>docs}}{{/class}}`
} else {
template = `{{#namespace name="${name}"}}{{>header~}}{{>body}}{{/namespace}}`
}
console.log(`rendering ${name}, template: ${template}`)
const output = jsdoc2md.renderSync({
data: templateData,
template: template,
partial: ["templates/partials/**/*.hbs"],
"global-index-format": "none",
"module-index-format": "none"
})
fs.writeFileSync(path.resolve(outputDir, `${name}.md`), output)
}
}
generateFiles(["src/*.js"])

17
docs/jsdoc.json vendored

@ -1,17 +0,0 @@
{
"plugins": [],
"recurseDepth": 10,
"source": {
"include": ["test"],
"includePattern": ".+\\.js(doc|x)?$",
"excludePattern": "(node_modules)"
},
"templates": {
"cleverLinks": false,
"monospaceLinks": false
},
"opts": {
"recurse": "true",
"destination": "./docs/"
}
}

19
docs/manual/Battery.md vendored

@ -1,19 +0,0 @@
Interface for object that holds info about battery. Battery object is not created by the theme's code, but rather by the **LightDM.Greeter** class.
# Members
## level
**Type**: [String]
The battery level.
## name
**Type**: [String]
The battery's name.
## state
**Type**: [String]
The state for the battery.

297
docs/manual/Greeter.md vendored

@ -1,297 +0,0 @@
Base class for the greeter's Theme JavaScript API. Greeter themes will interact directly with an object derived from this class to facilitate the user log-in process. The greeter will automatically create an instance when it starts. The instance can be accessed using the global variable: `lightdm`
# Methods
## authenticate(username)
Starts the authentication with the given `username`.
**Arguments**:
- `username` [String]
## authenticate_as_guest()
Authenticates as the guest user.
## batteryUpdate()
Updates the battery data.
## brightnessSet(quantity)
Set the brightness to `quantity`.
## brightnessIncrease(quantity)
Increase the brightness by `quantity`
## brightnessDecrease(quantity)
Decrease the brightness by `quantity`
## cancel_authentication()
Cancel the user authentication that is currently in progress.
## cancel_autologin()
Cancels the automatic login.
## hibernate()
Triggers the system to hibernate.
**Returns**:
- [Boolean]
`true` if hibernation initiated, otherwise `false`
## respond(response)
Provide a response to a greeter
**Arguments**:
- `response` [String]
## restart()
Triggers the system to restart.
**Returns**:
- [Boolean]
`true` if restart initiated, otherwise `false`
## set_language(language)
Set the language for the currently authenticated user.
**Arguments**:
- language [String]
The language specification (e.g 'de\_DE.UTF-8')
**Returns**:
- Boolean
`true` if successful, otherwise `false`
## shutdown()
Triggers the system to shutdown.
**Returns**:
- Boolean
`true` if successful, otherwise `false`
## start_session(session)
Starts a session for the authenticated user.
**Arguments**:
- `session` [String | Null]
The session to log into or null to use the default
**Returns**:
- Boolean
`true` if successful, otherwise `false`
## suspend()
Triggers the system to suspend/sleep.
**Returns**
- [Boolean]
`true` if suspend/sleep initiated, otherwise `false`
# Members
## authentication_user
**Type**: [String | Null]
**Readonly**
The username of the user being authenticated or null if there is no authentication in progress.
## autologin_guest
**Type**: [Boolean]
**Readonly**
Whether or not the guest account should be automatically logged into when the timer expires.
## autologin_timeout
**Type**: [Number]
**Readonly**
The number of seconds to wait before automatically loggin in.
## autologin_user
**Type**: [Boolean]
**Readonly**
The username with which to automatically log in when the timer expires.
## batteryData
**Type**: [LightDM.Battery]
**Readonly**
The battery data.
## brightness
**Type**: [Number]
The display brightness.
## can_access_battery
**Type**: [Boolean]
**Readonly**
Wheter or not the greeter can access to battery data.
## can_access_brightness
**Type**: [Boolean]
**Readonly**
Whether or not the greeter can control display brightness.
## can_hibernate
**Type**: [Boolean]
**Readonly**
Whether or not the greeter can make the system hibernate.
## can_restart
**Type**: [Boolean]
**Readonly**
Whether or not the greeter can make the system restart.
## can_shutdown
**Type**: [Boolean]
**Readonly**
Whether or not the greeter can make the system shutdown.
## can_suspend
**Type**: [Boolean]
**Readonly**
Whether or not the greeter can make the system suspend/sleep.
## default_session
**Type**: [String]
**Readonly**
The name of the default session
## has_guest_account
**Type**: [Boolean]
**Readonly**
Whether or not guest sessions are supported
## hide_users_hint
**Type**: [Boolean]
**Readonly**
Whether or not user accounts should be hidden
## hostname
**Type**: [String]
**Readonly**
The system's hostname
## in_authentication
**Type**: [Boolean]
**Readonly**
Whether or not the greeter is in the process of authenticating.
## is_authenticated
**Type**: [Boolean]
**Readonly**
Whether or not the greeter has succesfully authenticated.
## language
**Type**: [LightDM.Language | Null]
**Readonly**
The current language or `null` if no language.
## languages
**Type**: [Array&lt;LightDM.Language&gt;]
**Readonly**
A list of languages to present to the user.
## layout
**Type**: [LightDM.Layout]
**Readonly**
The currently active layout for the selected user.
## layouts
**Type**: [Array&lt;LightDM.Layout&gt;]
**Readonly**
A list of keyboard layouts to present to the user.
## lock_hint
**Type**: [Boolean]
**Readonly**
Whether or not the greeter was started as a lock screen.
## select_guest_hint
**Type**: [Boolean]
**Readonly**
Whether or not the guest account should be selected by default
## select_user_hint
**Type**: [String]
**Readonly**
The username to select by default.
## sessions
**Type**: [String]
**Readonly**
List of available sessions.
## show_manual_login_hint
**Type**: [Boolean]
**Readonly**
Check if manual login should be shown. If `true`, the theme should provide a way for username to be entered manually. Otherwise, themes that show a user list may limit logins to only those users.
## show_remote_login_hint
**Type**: [Boolean]
**Readonly**
Check if a remote login option should be shown. If `true`, the theme should provide a way for a user to log into a remote desktop server.
## users
**Type**: [Array&lt;LightDM.User&gt;]
**Readonly**
List of available users.
# Signals
## authentication_complete
**Type**: [Signal]
Gets emitted when the greeter has completed authentication.
## autologin_timer_expired
**Type**: [Signal]
Gets emitted when the automatic login timer has expired.
## brightness_update
**Type**: [Signal]
Gets emitted when brightness is updated.
## idle
**Type**: [Signal]
Gets emitted when the user has logged in and the greeter is no longer needed.
## reset
**Type**: [Signal]
Gets emitted when the user is returning to a greeter that was previously marked idle.
## show_message
**Type**: [Signal]
Get emitted when the greeter should show a message to the user.
## show_prompt
**Type**: [Signal]
Gets emitted when the greeter should show a prompt to the user.

53
docs/manual/GreeterConfig.md vendored

@ -1,53 +0,0 @@
Provides greeter themes with a way to access values from the greeter's config file located at **/etc/lightdm/web-greeter.yml**. The greeter will create an instance of this class when it starts. The instance can be accessed with the global variable: `greeter_config`
# Members
## branding
**Type**: [Object]
Holds keys&values from the **branding** section of the config file.
**Properties**:
- **background_images_dir**
Path to directory that contains background images for use in greeter themes.
- **logo_image**
Path to distro logo image for use in greeter themes
- **user_image**
Default user image/avatar.
## greeter
**Type**: [Object]
Holds keys/values from the **greeter** section of the config file.
**Properties**:
- **debug_mode**
Greeter theme debug mode.
- **detect_theme_errors**
Provide an option to load default theme when theme errors are detected.
- **screensaver_timeout**
Blank the screen after this seconds of inactivity.
- **secure_mode**
Don't allow themes to make http requests.
- **time_format**
A moment.js format string to be used by the greeter to generate localized time for display.
- **time_language**
Language to use when displaying the time, or **auto** to use the system's language.
- **theme**
The name of the theme to be used by the greeter.
## features
**Type**: [Object]
Holds keys/values from the **features** section of the config file.
**Properties**:
- **battery**
Enable greeter and themes to get battery status.
- **backlight**
- **enabled**
Enable greeter and themes to control display backlight.
- **value**
The amount to increase/decrease brightness by greeter.
- **steps**
How many steps are needed to do the change. **0** for instant change

18
docs/manual/Language.md vendored

@ -1,18 +0,0 @@
Interface for object that holds info about a language on the system. Language objects are not created by the theme's code, but rather by the **LightDM.Greeter** class.
# Members
## code
**Type**: [String]
The code for the language.
## name
**Type**: [String]
The name for the layout.
## territory
**Type**: [String]
The territory for the language.

18
docs/manual/Layout.md vendored

@ -1,18 +0,0 @@
Interface for object that holds info about a keyboard layout on the system. Language objects are not created by the theme's code, but rather by the **LightDM.Greeter** class.
# Members
## description
**Type**: [String]
The description for the layout.
## name
**Type**: [String]
The name for the layout.
## short_description
**Type**: [String]
The territory for the layout.

23
docs/manual/Session.md vendored

@ -1,23 +0,0 @@
Interface for object that holds info about a session. Session objects are not created by the theme's code, but rather by the **LightDM.Greeter** class.
# Members
## comment
**Type**: [String]
The comment for the session.
## key
**Type**: [String]
The key for the session.
## name
**Type**: [String]
The name for the session.
## Type
**Type**: [String]
The type for the sesion.

39
docs/manual/ThemeUtils.md vendored

@ -1,39 +0,0 @@
Provides various utility methods for use in greeter themes. The greeter will automatically create an instance of this class when it starts. The instance can be accessed with the global variable: `theme_utils`
# Methods
## bind_this(context)
Bind **this** to class, **context**, for all of the class's methods.
**Arguments**:
- `context` [Object]
An ES6 class instance with at least one method.
**Returns**:
- Object
**context** with **this** bound to it for all of its methods.
## dirlist(path)
Returns the contents of a directory found at **path**, only if the **path** meets at least one of the following conditions:
- Is located whithin the greeter theme's root directory.
- Has been explicitly allowed in the greeter's config file.
- Is located within the greeter's shared data directory (**/var/lib/lightdm-data/**)
- Is located in **/tmp**.
**Arguments**:
- `path` [String]
The abs path to desired directory.
**Returns**:
- Array&lt;String&gt;
List of abs paths for the files and directories found in **path**
## get_current_localized_time()
Get the current time in a localized format. Time format and language are auto-detected by default, but can be set manually in the greeter config file.
- **language** defaults to the system's language, but can be set manually in the config gile.
- When **time_format** config file option has a valid value, time will be formatted according to that value.
- When **time_format** does not have a valid value, the time format will be **LT** which is **1:00 PM** or **13:00** depending on the system's locale.
**Returns**:
- String
The current localized time.

43
docs/manual/User.md vendored

@ -1,43 +0,0 @@
Interface for object that holds info about a user account on the system. User objects are not created by the theme's code, but rather by the **LightDM.Greeter** class.
# Members
## display_name
**Type**: [String]
The display name for the user.
## home_directory
**Type**: [String]
The home directory for the user.
## image
**Type**: [String]
The image for the user.
## language
**Type**: [String]
The language for the user.
## layout
**Type**: [String]
The keyboard layout for the user.
## logged_in
**Type**: [Boolean]
Whether or not the user is currently logged in.
## session
**Type**: [String]
The last session that the user logged into.
## username
**Type**: [String]
The username for the user.

7496
docs/package-lock.json generated vendored

File diff suppressed because it is too large Load Diff

22
docs/package.json vendored

@ -1,22 +0,0 @@
{
"name": "docs",
"version": "1.0.0",
"description": "",
"main": "index.js",
"directories": {
"src": "src"
},
"scripts": {
"docs": "node index.js",
"clean": "rm docs/api/* -f",
"build": "honkit build",
"serve": "honkit serve"
},
"keywords": [],
"author": "",
"license": "ISC",
"devDependencies": {
"honkit": "^3.6.20",
"jsdoc-to-markdown": "^7.0.1"
}
}

3
docs/templates/partials/all-docs/all-docs.hbs vendored

@ -1,3 +0,0 @@
{{#orphans ~}}
{{>docs~}}
{{/orphans~}}

2
docs/templates/partials/all-docs/docs/body/access.hbs vendored

@ -1,2 +0,0 @@
{{#if access}}**Access**: {{{access}}}
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/augments.hbs vendored

@ -1,2 +0,0 @@
{{#if augments}}**Extends**: {{>linked-type-list types=augments delimiter=", " }}
{{/if}}

2
docs/templates/partials/all-docs/docs/body/authors.hbs vendored

@ -1,2 +0,0 @@
{{#if author}}{{#each author}}**Author**: {{{inlineLinks this}}}
{{/each}}{{/if~}}

29
docs/templates/partials/all-docs/docs/body/body.hbs vendored

@ -1,29 +0,0 @@
{{>deprecated~}}
{{>description~}}
{{!-- {{>scope~}} --}}
{{>summary~}}
{{>augments~}}
{{>implements~}}
{{>mixes~}}
{{>default~}}
{{>chainable~}}
{{>overrides~}}
{{>returns~}}
{{>category~}}
{{>throws~}}
{{>fires~}}
{{>this~}}
{{>access~}}
{{>readOnly~}}
{{>requires~}}
{{>customTags~}}
{{>see~}}
{{>since~}}
{{>version~}}
{{>authors~}}
{{>license~}}
{{>copyright~}}
{{>todo~}}
{{>params~}}
{{>properties~}}
{{>examples~}}

2
docs/templates/partials/all-docs/docs/body/category.hbs vendored

@ -1,2 +0,0 @@
{{#if category}}**Category**: {{inlineLinks category}}
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/chainable.hbs vendored

@ -1,2 +0,0 @@
{{#if chainable}}**Chainable**
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/copyright.hbs vendored

@ -1,2 +0,0 @@
{{#if copyright}}**Copyright**: {{{inlineLinks copyright}}}
{{/if~}}

3
docs/templates/partials/all-docs/docs/body/customTags.hbs vendored

@ -1,3 +0,0 @@
{{#if customTags}}{{#each customTags}}**{{titleCase tag}}**: {{#with (parseType value)~}}
{{#if type}}{{>link to=type}}{{/if}}{{#if description}}{{{inlineLinks description}}}{{/if}}{{/with}}
{{/each}}{{/if~}}

2
docs/templates/partials/all-docs/docs/body/default.hbs vendored

@ -1,2 +0,0 @@
{{#unless (equal defaultvalue undefined)}}**Default**: {{>defaultvalue}}
{{/unless}}

3
docs/templates/partials/all-docs/docs/body/deprecated.hbs vendored

@ -1,3 +0,0 @@
{{#if deprecated}}***Deprecated***
{{/if~}}

3
docs/templates/partials/all-docs/docs/body/description.hbs vendored

@ -1,3 +0,0 @@
{{#if description}}{{{inlineLinks description}}}
{{/if}}

4
docs/templates/partials/all-docs/docs/body/examples.hbs vendored

@ -1,4 +0,0 @@
{{#examples}}
**Example**{{#if caption}} *({{caption}})* {{else}} {{/if}}
{{{inlineLinks example}}}
{{/examples}}

3
docs/templates/partials/all-docs/docs/body/fires.hbs vendored

@ -1,3 +0,0 @@
{{#if fires~}}
**Emits**: {{>linked-type-list types=fires delimiter=", " }}
{{/if}}

2
docs/templates/partials/all-docs/docs/body/implements.hbs vendored

@ -1,2 +0,0 @@
{{#if implements}}**Implements**: {{>linked-type-list types=implements delimiter=", " }}
{{/if}}

2
docs/templates/partials/all-docs/docs/body/license.hbs vendored

@ -1,2 +0,0 @@
{{#if license}}**License**: {{inlineLinks license}}
{{/if~}}

3
docs/templates/partials/all-docs/docs/body/mixes.hbs vendored

@ -1,3 +0,0 @@
{{#if mixes~}}
**Mixes**: {{>linked-type-list types=mixes delimiter=", " }}
{{/if}}

2
docs/templates/partials/all-docs/docs/body/overrides.hbs vendored

@ -1,2 +0,0 @@
{{#if overrides}}**Overrides**: {{>link to=overrides}}
{{/if~}}

4
docs/templates/partials/all-docs/docs/body/params/param-table-name.hbs vendored

@ -1,4 +0,0 @@
{{#if optional}}[{{/if~}}
{{#if variable}}...{{/if~}}
{{{name}~}}
{{#if optional}}]{{/if}}

9
docs/templates/partials/all-docs/docs/body/params/params-list.hbs vendored

@ -1,9 +0,0 @@
{{#if params}}
{{#params}}**Params**
{{#each this~}}
{{indent}}- {{name}}{{#if type}} {{>linked-type-list types=type.names delimiter=" | " }}{{/if}}{{#unless (equal defaultvalue undefined)}} {{>defaultvalue equals=true ~}}{{/unless}}{{#if description}} - {{{inlineLinks description}}}{{/if}}
{{/each}}
{{/params~}}
{{/if}}

20
docs/templates/partials/all-docs/docs/body/params/params-table-html.hbs vendored

@ -1,20 +0,0 @@
{{#if params}}
<table>
<thead>
<tr>
{{#each (tableHeadHtml params "name|Param" "type|Type" "defaultvalue|Default" "description|Description")}}<th>{{this}}</th>{{/each}}
</tr>
</thead>
<tbody>
{{#tableRow params "name" "type" "defaultvalue" "description" ~}}
<tr>
{{#if @col1}}<td>{{>param-table-name}}</td>{{/if~}}
{{#if @col2}}<td>{{>linked-type-list types=type.names delimiter=" | " html=true}}</td>{{/if~}}
{{#if @col3}}<td>{{>defaultvalue}}</td>{{/if~}}
{{#if @col4}}<td>{{{md (inlineLinks description)}}}</td>{{/if}}
</tr>
{{~/tableRow}}
</tbody>
</table>
{{/if}}

12
docs/templates/partials/all-docs/docs/body/params/params-table.hbs vendored

@ -1,12 +0,0 @@
{{#if params}}
{{tableHead params "name|Param" "type|Type" "defaultvalue|Default" "description|Description" ~}}
{{#tableRow params "name" "type" "defaultvalue" "description" ~}}
| {{#if @col1}}{{>param-table-name}} | {{/if~}}
{{#if @col2}}{{>linked-type-list types=type.names delimiter=" \| " }} | {{/if~}}
{{#if @col3}}{{>defaultvalue}} | {{/if~}}
{{#if @col4}}{{{stripNewlines (inlineLinks description)}}} |{{/if}}
{{/tableRow}}
{{/if}}

4
docs/templates/partials/all-docs/docs/body/params/params.hbs vendored

@ -1,4 +0,0 @@
{{#if (optionEquals "param-list-format" "list")}}{{>params-list~}}{{/if~}}
{{#if (optionEquals "param-list-format" "table")~}}
{{#if (optionEquals "no-gfm" true)}}{{>params-table-html~}}{{else}}{{>params-table~}}{{/if~}}
{{/if~}}

7
docs/templates/partials/all-docs/docs/body/properties/properties-list.hbs vendored

@ -1,7 +0,0 @@
{{#if properties}}**Properties**
{{#each properties~}}
{{#if (regexp-test name "\w+\.\w+")}} {{/if}}- {{{name}}} {{>linked-type-list types=type.names delimiter=" \| " ~}}{{#if description}} - {{{inlineLinks description}}}{{/if}}
{{/each}}
{{/if~}}

21
docs/templates/partials/all-docs/docs/body/properties/properties-table-html.hbs vendored

@ -1,21 +0,0 @@
{{#if properties~}}**Properties**
<table>
<thead>
<tr>
{{#each (tableHeadHtml properties "name|Name" "type|Type" "defaultvalue|Default" "description|Description")}}<th>{{this}}</th>{{/each}}
</tr>
</thead>
<tbody>
{{#tableRow properties "name" "type" "defaultvalue" "description" ~}}
<tr>
{{#if @col1}}<td>{{>param-table-name}}</td>{{/if~}}
{{#if @col2}}<td>{{>linked-type-list types=type.names delimiter=" | " html=true}}</td>{{/if~}}
{{#if @col3}}<td>{{>defaultvalue}}</td>{{/if~}}
{{#if @col4}}<td>{{{md (inlineLinks description)}}}</td>{{/if}}
</tr>
{{~/tableRow}}
</tbody>
</table>
{{/if}}

12
docs/templates/partials/all-docs/docs/body/properties/properties-table.hbs vendored

@ -1,12 +0,0 @@
{{#if properties}}**Properties**
{{tableHead properties "name|Name" "type|Type" "defaultvalue|Default" "description|Description" ~}}
{{#tableRow properties "name" "type" "defaultvalue" "description" ~}}
| {{#if @col1}}{{>param-table-name}} | {{/if~}}
{{#if @col2}}{{>linked-type-list types=type.names delimiter=" \| " }} | {{/if~}}
{{#if @col3}}{{>defaultvalue}} | {{/if~}}
{{#if @col4}}{{{stripNewlines (inlineLinks description)}}} |{{/if}}
{{/tableRow}}
{{/if}}

4
docs/templates/partials/all-docs/docs/body/properties/properties.hbs vendored

@ -1,4 +0,0 @@
{{#if (optionEquals "property-list-format" "list")}}{{>properties-list~}}{{/if~}}
{{#if (optionEquals "property-list-format" "table")~}}
{{#if (optionEquals "no-gfm" true)}}{{>properties-table-html}}{{else}}{{>properties-table}}{{/if~}}
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/readOnly.hbs vendored

@ -1,2 +0,0 @@
{{#if readonly}}**Read only**: true
{{/if~}}

3
docs/templates/partials/all-docs/docs/body/requires.hbs vendored

@ -1,3 +0,0 @@
{{#if requires~}}
**Requires**: {{>linked-type-list types=requires delimiter=", " }}
{{/if}}

12
docs/templates/partials/all-docs/docs/body/returns.hbs vendored

@ -1,12 +0,0 @@
{{#if returns}}
{{#if returns.[0].description~}}
**Returns**: {{#each returns~}}
{{#if type~}}
{{#if type.names}}{{>linked-type-list types=type.names delimiter=" \| " ~}}{{/if}}
{{~#if description}} - {{{inlineLinks description}}}{{/if~}}
{{else~}}
{{{inlineLinks description}~}}
{{/if~}}
{{~/each}}
{{/if}}{{/if}}

10
docs/templates/partials/all-docs/docs/body/scope.hbs vendored

@ -1,10 +0,0 @@
{{#if scope}}
**Kind**: {{#if (equal kind "event") ~}}
event emitted{{#if memberof}} by {{>link to=memberof}}{{/if}}
{{else~}}
{{scope}} {{#if virtual}}abstract {{/if}}{{kindInThisContext}}{{#if memberof}} of {{>link to=memberof}}{{/if}}
{{/if~}}
{{else~}}
{{#if isExported}}**Kind**: Exported {{kind}}
{{/if~}}
{{/if~}}

12
docs/templates/partials/all-docs/docs/body/see.hbs vendored

@ -1,12 +0,0 @@
{{#if see~}}
{{#if (equal see.length 1)~}}
**See**: {{{inlineLinks see.[0]}}}
{{else~}}
**See**
{{#each see}}- {{{inlineLinks this}}}
{{/each}}
{{/if~}}
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/since.hbs vendored

@ -1,2 +0,0 @@
{{#if since}}**Since**: {{{inlineLinks since}}}
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/summary.hbs vendored

@ -1,2 +0,0 @@
{{#if summary}}**Summary**: {{{inlineLinks summary}}}
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/this.hbs vendored

@ -1,2 +0,0 @@
{{#if thisvalue}}**this**: {{>link to=thisvalue}}
{{/if~}}

8
docs/templates/partials/all-docs/docs/body/throws.hbs vendored

@ -1,8 +0,0 @@
{{#if exceptions~}}
**Throws**:
{{#each exceptions~}}
- {{#if type.names}}{{>linked-type-list types=type.names}} {{/if}}{{{inlineLinks description}}}
{{/each}}
{{/if}}

22
docs/templates/partials/all-docs/docs/body/todo.hbs vendored

@ -1,22 +0,0 @@
{{#if todoList~}}
**Todo**
{{#if (option "no-gfm")~}}
{{#each todoList~}}
{{#if done}}- {{{inlineLinks task}}}
{{else}}- {{{inlineLinks task}}}
{{/if~}}
{{/each~}}
{{else~}}
{{#each todoList~}}
{{#if done}}- [x] {{{inlineLinks task}}}
{{else}}- [ ] {{{inlineLinks task}}}
{{/if~}}
{{/each~}}
{{/if}}
{{/if~}}

2
docs/templates/partials/all-docs/docs/body/version.hbs vendored

@ -1,2 +0,0 @@
{{#if version}}**Version**: {{inlineLinks version}}
{{/if~}}

5
docs/templates/partials/all-docs/docs/docs.hbs vendored

@ -1,5 +0,0 @@
{{>header~}}
{{>body}}
{{!-- {{>member-index~}} --}}
{{>separator~}}
{{>members~}}

3
docs/templates/partials/all-docs/docs/header.hbs vendored

@ -1,3 +0,0 @@
<a id="{{{anchorName}}}"></a>
{{>heading-indent}}{{>sig-name}}

4
docs/templates/partials/all-docs/docs/member-index/member-index-grouped.hbs vendored

@ -1,4 +0,0 @@
{{string-repeat " " (add level baseLevel)}}* {{#unless (equal _title undefined)}}_{{_title}}_{{else}}{{>sig-link}}{{/unless}}
{{#groupBy (option "group-by")~}}
{{>member-index-grouped baseLevel=(add ../level ../baseLevel 1)~}}
{{/groupBy~}}

4
docs/templates/partials/all-docs/docs/member-index/member-index-list.hbs vendored

@ -1,4 +0,0 @@
{{>index-indent}}* {{>sig-link-parent}}
{{#indexChildren ~}}
{{>member-index-list~}}
{{/indexChildren}}

26
docs/templates/partials/all-docs/docs/member-index/member-index.hbs vendored

@ -1,26 +0,0 @@
{{setLevel this 0~}}
{{#if (descendants min=(option 'memberIndex.minDescendants'))~}}
{{#if isExported~}}
{{#if (equal (depth) 0)}}
{{#if (optionEquals "member-index-format" "list")}}
{{>member-index-list}}
{{else~}}
{{>member-index-grouped}}
{{/if~}}
{{/if~}}
{{else~}}
{{#if (optionEquals "member-index-format" "list")}}
{{>member-index-list}}
{{else}}
{{>member-index-grouped}}
{{/if~}}
{{/if~}}
{{/if}}

3
docs/templates/partials/all-docs/docs/members.hbs vendored

@ -1,3 +0,0 @@
{{#children inherited=undefined ~}}
{{>docs~}}
{{/children~}}

11
docs/templates/partials/main-index/global-index/global-index-dl.hbs vendored

@ -1,11 +0,0 @@
{{#globals kind=kind ~}}
{{#if @first~}}{{>heading-indent}}{{../title}}
<dl>
{{/if~}}
<dt>{{>sig-link-html}}</dt>
<dd>{{{md (inlineLinks description)}}}</dd>
{{#if @last~}}</dl>
{{/if~}}
{{/globals~}}

9
docs/templates/partials/main-index/global-index/global-index-grouped.hbs vendored

@ -1,9 +0,0 @@
{{#globals kind=kind~}}
{{#if @first~}}{{>heading-indent}}{{../title}}
{{/if~}}
{{>member-index-grouped~}}
{{#if @last}}
{{/if~}}
{{/globals}}

11
docs/templates/partials/main-index/global-index/global-index-kinds.hbs vendored

@ -1,11 +0,0 @@
{{#unless (optionEquals "global-index-format" "none")~}}
{{#if (optionEquals "global-index-format" "dl")}}
{{>global-index-dl kind=kind title=title ~}}
{{/if~}}
{{#if (optionEquals "global-index-format" "grouped")}}
{{>global-index-grouped kind=kind title=title }}
{{/if~}}
{{#if (optionEquals "global-index-format" "table")}}
{{>global-index-table kind=kind title=title ~}}
{{/if~}}
{{/unless~}}

22
docs/templates/partials/main-index/global-index/global-index-table.hbs vendored

@ -1,22 +0,0 @@
{{#globals kind=kind~}}
{{#if @first~}}
{{>heading-indent}}{{../title}}
<table>
<thead>
<tr>
<th>Global</th><th>Description</th>
</tr>
</thead>
<tbody>
{{/if~}}
<tr>
<td>{{>sig-link-html}}</td>
<td>{{{md (inlineLinks description)}}}</td>
</tr>
{{#if @last~}}
</tbody>
</table>
{{/if~}}
{{/globals}}

10
docs/templates/partials/main-index/global-index/global-index.hbs vendored

@ -1,10 +0,0 @@
{{>global-index-kinds kind="class" title="Classes" ~}}
{{>global-index-kinds kind="mixin" title="Mixins" ~}}
{{>global-index-kinds kind="member" title="Members" ~}}
{{>global-index-kinds kind="namespace" title="Objects" ~}}
{{>global-index-kinds kind="constant" title="Constants" ~}}
{{>global-index-kinds kind="function" title="Functions" ~}}
{{>global-index-kinds kind="event" title="Events" ~}}
{{>global-index-kinds kind="typedef" title="Typedefs" ~}}
{{>global-index-kinds kind="external" title="External" ~}}
{{>global-index-kinds kind="interface" title="Interfaces" ~}}

6
docs/templates/partials/main-index/main-index.hbs vendored

@ -1,6 +0,0 @@
{{! a main index is only shown if at least 2 global or modules exist ~}}
{{#if (showMainIndex)~}}
{{>module-index~}}
{{>global-index~}}
{{/if~}}

11
docs/templates/partials/main-index/module-index/module-index-dl.hbs vendored

@ -1,11 +0,0 @@
{{#modules~}}
{{#if @first~}}{{>heading-indent}}Modules
<dl>
{{/if~}}
<dt>{{>sig-link-html}}</dt>
<dd>{{{md (inlineLinks description)}}}</dd>
{{#if @last~}}</dl>
{{/if~}}
{{/modules~}}

7
docs/templates/partials/main-index/module-index/module-index-grouped.hbs vendored

@ -1,7 +0,0 @@
{{#modules~}}
{{#if @first~}}{{>heading-indent}}Modules
{{/if~}}
{{>member-index-grouped~}}
{{/modules}}

22
docs/templates/partials/main-index/module-index/module-index-table.hbs vendored

@ -1,22 +0,0 @@
{{#modules~}}
{{#if @first~}}
{{>heading-indent}}Modules
<table>
<thead>
<tr>
<th>Module</th><th>Description</th>
</tr>
</thead>
<tbody>
{{/if~}}
<tr>
<td>{{>sig-link-html}}</td>
<td>{{{md (inlineLinks description)}}}</td>
</tr>
{{#if @last~}}
</tbody>
</table>
{{/if~}}
{{/modules}}

5
docs/templates/partials/main-index/module-index/module-index.hbs vendored

@ -1,5 +0,0 @@
{{#unless (optionEquals "module-index-format" "none")~}}
{{#if (optionEquals "module-index-format" "dl")}}{{>module-index-dl ~}}{{/if~}}
{{#if (optionEquals "module-index-format" "grouped")}}{{>module-index-grouped ~}}{{/if~}}
{{#if (optionEquals "module-index-format" "table")}}{{>module-index-table ~}}{{/if~}}
{{/unless~}}

2
docs/templates/partials/main.hbs vendored

@ -1,2 +0,0 @@
{{>main-index~}}
{{>all-docs~}}

1
docs/templates/partials/shared/heading-indent.hbs vendored

@ -1 +0,0 @@
{{string-repeat "#" (headingDepth)}}

1
docs/templates/partials/shared/index-indent.hbs vendored

@ -1 +0,0 @@
{{string-repeat " " (indexDepth)}}

5
docs/templates/partials/shared/separator.hbs vendored

@ -1,5 +0,0 @@
{{#if (option "separators")}}
* * *
{{/if~}}

14
docs/templates/partials/shared/signature/sig-link-html.hbs vendored

@ -1,14 +0,0 @@
{{#if name}}{{#sig no-gfm=true ~}}
{{{@depOpen}~}}
<a href="#{{{anchorName}}}">
{{~{@codeOpen}~}}
{{#if @prefix}}{{@prefix}} {{/if~}}
{{@accessSymbol}}{{#if (isEvent)}}"{{{name}}}"{{else}}{{{name}}}{{/if~}}
{{~#if @methodSign}}{{#if (isEvent)}} {{@methodSign}}{{else}}{{@methodSign}}{{/if}}{{/if~}}
{{{@codeClose}~}}
</a>
{{~#if @returnSymbol}} {{@returnSymbol}}{{/if~}}
{{#if @returnTypes}} {{>linked-type-list types=@returnTypes html=true delimiter=" | " }}{{/if~}}
{{#if @suffix}} {{@suffix}}{{/if~}}
{{{@depClose}~}}
{{~/sig}}{{/if~}}

13
docs/templates/partials/shared/signature/sig-link-parent.hbs vendored

@ -1,13 +0,0 @@
{{#if name}}{{#sig~}}
{{{@depOpen}~}}
[{{{@codeOpen}~}}
{{#if @prefix}}{{@prefix}} {{/if~}}
{{#if (isClassMember)}}{{@parent~}}{{/if~}}
{{@accessSymbol}}{{#if (isEvent)}}"{{{name}}}"{{else}}{{{name}}}{{/if~}}
{{~#if @methodSign}}{{#if (isEvent)}} {{@methodSign}}{{else}}{{@methodSign}}{{/if}}{{/if~}}
{{{@codeClose}}}](#{{{anchorName}}})
{{~#if @returnSymbol}} {{@returnSymbol}}{{/if~}}
{{#if @returnTypes}} {{>linked-type-list types=@returnTypes delimiter=" \| " }}{{/if~}}
{{#if @suffix}} {{@suffix}}{{/if~}}
{{{@depClose}~}}
{{~/sig}}{{/if~}}

14
docs/templates/partials/shared/signature/sig-link.hbs vendored

@ -1,14 +0,0 @@
{{#if virtual}}*{{/if}}{{#with (parentObject)}}{{#if virtual}}*{{/if~}}{{/with~}}
{{#if name}}{{#sig~}}
{{{@depOpen}~}}
[{{{@codeOpen}~}}
{{#if @prefix}}{{@prefix}} {{/if~}}
{{@accessSymbol}}{{#if (isEvent)}}"{{{name}}}"{{else}}{{{name}}}{{/if~}}
{{~#if @methodSign}}{{#if (isEvent)}} {{@methodSign}}{{else}}{{@methodSign}}{{/if}}{{/if~}}
{{{@codeClose}}}](#{{{anchorName}}})
{{~#if @returnSymbol}} {{@returnSymbol}}{{/if~}}
{{#if @returnTypes}} {{>linked-type-list types=@returnTypes delimiter=" \| " }}{{/if~}}
{{#if @suffix}} {{@suffix}}{{/if~}}
{{{@depClose}~}}
{{~/sig}}{{/if~}}
{{#if virtual}}*{{/if}}{{#with (parentObject)}}{{#if virtual}}*{{/if~}}{{/with~}}

15
docs/templates/partials/shared/signature/sig-name.hbs vendored

@ -1,15 +0,0 @@
{{#if virtual}}*{{/if}}{{#with (parentObject)}}{{#if virtual}}*{{/if~}}{{/with~}}
{{#if name}}{{#sig~}}
{{{@depOpen}~}}
{{{@codeOpen}~}}
{{#if @prefix}}{{@prefix}} {{/if~}}
{{@parent~}}
{{@accessSymbol}}{{#if (isEvent)}}"{{{name}}}"{{else}}{{{escape name}}}{{/if~}}
{{#if @methodSign}}{{#if (isEvent)}} {{@methodSign}}{{else}}{{@methodSign}}{{/if}}{{/if~}}
{{{@codeClose}~}}
{{#if @returnSymbol}} {{@returnSymbol}}{{/if~}}
{{#if @returnTypes}} {{>linked-type-list types=@returnTypes delimiter=" \| " }}{{/if~}}
{{#if @suffix}} {{@suffix}}{{/if~}}
{{{@depClose}~}}
{{~/sig}}{{/if~}}
{{#if virtual}}*{{/if}}{{#with (parentObject)}}{{#if virtual}}*{{/if~}}{{/with~}}

1
docs/templates/partials/shared/value/defaultvalue.hbs vendored

@ -1 +0,0 @@
{{#unless (equal defaultvalue undefined)}}<code>{{#if equals}} = {{/if}}{{#if (equal type.names.[0] "string")}}{{json-stringify defaultvalue}}{{else}}{{defaultvalue}}{{/if}}</code>{{/unless}}

25
docs/templates/partials/shared/value/link.hbs vendored

@ -1,25 +0,0 @@
{{! usage: link to="namepath" html=true/false caption="optional caption"~}}
{{~#if html~}}
<code>
{{~#link to~}}
{{#if url~}}
<a href="{{{url}}}">{{#if ../../caption}}{{../../../caption}}{{else}}{{name}}{{/if}}</a>
{{~else~}}
{{#if ../../caption}}{{../../../caption}}{{else}}{{name}}{{/if~}}
{{/if~}}
{{/link~}}
</code>
{{~else~}}
{{#link to~}}
{{#if url~}}
[<code>{{#if ../../caption}}{{escape ../../../caption}}{{else}}{{escape name}}{{/if}}</code>]({{{url}}})
{{~else~}}
<code>{{#if ../../caption}}{{escape ../../../caption}}{{else}}{{escape name}}{{/if~}}</code>
{{~/if~}}
{{/link~}}
{{/if~}}

4
docs/templates/partials/shared/value/linked-type-list.hbs vendored

@ -1,4 +0,0 @@
{{#each types~}}
{{>link to=this html=../html ~}}
{{#unless @last}}{{{../delimiter}}}{{/unless~}}
{{/each}}
Loading…
Cancel
Save