fix formatting
This commit is contained in:
parent
85362caf96
commit
db9d56cf82
10 changed files with 46 additions and 31 deletions
|
@ -2,4 +2,3 @@
|
||||||
|
|
||||||
Packaging is a way to distribute an AddonScript file and associated files together in a single file.
|
Packaging is a way to distribute an AddonScript file and associated files together in a single file.
|
||||||
Currently, the only specified ackaging way is [zip-based packaging](zip.md).
|
Currently, the only specified ackaging way is [zip-based packaging](zip.md).
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
# Addon Object
|
# Addon Object
|
||||||
|
|
||||||
``` json
|
```json
|
||||||
{
|
{
|
||||||
"addonscript": {},
|
"addonscript": {},
|
||||||
"id": "myaddon",
|
"id": "myaddon",
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
# AddonScript Object
|
# AddonScript Object
|
||||||
|
|
||||||
``` json
|
```json
|
||||||
{
|
{
|
||||||
"version": 2
|
"version": 2
|
||||||
}
|
}
|
||||||
|
@ -11,8 +11,8 @@ Future fields may be added.
|
||||||
# Required properties
|
# Required properties
|
||||||
|
|
||||||
## version
|
## version
|
||||||
|
|
||||||
This is the version of the addonscript format the file is written in.
|
This is the version of the addonscript format the file is written in.
|
||||||
|
|
||||||
The specification you are reading is for version 2. Version 1 is an old version which is deprecated,
|
The specification you are reading is for version 2. Version 1 is an old version which is deprecated,
|
||||||
and doesn't have to be (and shouldn't be) implemented by tools using addonscript.
|
and doesn't have to be (and shouldn't be) implemented by tools using addonscript.
|
||||||
|
|
||||||
|
|
|
@ -79,6 +79,7 @@ cannot be referenced, as only addon-ids are used.
|
||||||
</td>
|
</td>
|
||||||
<td>
|
<td>
|
||||||
|
|
||||||
|
<!-- prettier-ignore -->
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"companion": [
|
"companion": [
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
# File Object
|
# File Object
|
||||||
|
|
||||||
``` json
|
```json
|
||||||
{
|
{
|
||||||
"id": "modfile",
|
"id": "modfile",
|
||||||
"url": "https://example.com/mymod.jar",
|
"url": "https://example.com/mymod.jar",
|
||||||
|
@ -19,13 +19,14 @@ This is the ID of the file.
|
||||||
It should be written in the `kebab-case` format, meaning lowercase only and using `-` instead of spaces.
|
It should be written in the `kebab-case` format, meaning lowercase only and using `-` instead of spaces.
|
||||||
|
|
||||||
<!--TODO: error if there are multiple relations with the same id and allow multiple urls-->
|
<!--TODO: error if there are multiple relations with the same id and allow multiple urls-->
|
||||||
|
|
||||||
If multiple file objects in the same array have the same ID, they are treated as the same file,
|
If multiple file objects in the same array have the same ID, they are treated as the same file,
|
||||||
which means that the first one of them in the array will be used unless it can't be retrieved from the URL,
|
which means that the first one of them in the array will be used unless it can't be retrieved from the URL,
|
||||||
in which case the next one will be used as a fallback.
|
in which case the next one will be used as a fallback.
|
||||||
|
|
||||||
### url
|
### url
|
||||||
|
|
||||||
This is an [URL](../url.md), which points to the actual file.
|
This is a [URL](../url.md), which points to the actual file.
|
||||||
|
|
||||||
### install
|
### install
|
||||||
|
|
||||||
|
|
|
@ -1,11 +1,11 @@
|
||||||
# Meta Object
|
# Meta Object
|
||||||
|
|
||||||
``` json
|
```json
|
||||||
{
|
{
|
||||||
"addon": {
|
"addon": {
|
||||||
"name": "My cool addon name",
|
"name": "My cool addon name",
|
||||||
"icon": "./icon.png",
|
"icon": "./icon.png",
|
||||||
"description":"./README.md",
|
"description": "./README.md",
|
||||||
"summary": "My Addon",
|
"summary": "My Addon",
|
||||||
"website": "https://example.com",
|
"website": "https://example.com",
|
||||||
"source": "https://gitea.com/user/myaddon",
|
"source": "https://gitea.com/user/myaddon",
|
||||||
|
@ -23,12 +23,15 @@
|
||||||
## Optional properties
|
## Optional properties
|
||||||
|
|
||||||
### addon
|
### addon
|
||||||
|
|
||||||
An [addon mata](#addon-meta-object) object.
|
An [addon mata](#addon-meta-object) object.
|
||||||
|
|
||||||
### version
|
### version
|
||||||
|
|
||||||
A [version mata](#version-meta-object) object.
|
A [version mata](#version-meta-object) object.
|
||||||
|
|
||||||
### additional
|
### additional
|
||||||
|
|
||||||
This object can contain any arbitrary data,
|
This object can contain any arbitrary data,
|
||||||
|
|
||||||
# Addon Meta Object
|
# Addon Meta Object
|
||||||
|
@ -36,29 +39,37 @@ This object can contain any arbitrary data,
|
||||||
## Optional Properties
|
## Optional Properties
|
||||||
|
|
||||||
### name
|
### name
|
||||||
|
|
||||||
The full, human-readable name of the addon. This is what a program such as a launcher should
|
The full, human-readable name of the addon. This is what a program such as a launcher should
|
||||||
display to the user.
|
display to the user.
|
||||||
|
|
||||||
### icon
|
### icon
|
||||||
|
|
||||||
A path to the icon of the addon. This path should point to an image file of small resolution
|
A path to the icon of the addon. This path should point to an image file of small resolution
|
||||||
which is ideally square. It can be dispayed to users in programs.
|
which is ideally square. It can be dispayed to users in programs.
|
||||||
|
|
||||||
### description
|
### description
|
||||||
|
|
||||||
A path to a description file for the addon. The file should be in CommonMark markdown.
|
A path to a description file for the addon. The file should be in CommonMark markdown.
|
||||||
|
|
||||||
### summary
|
### summary
|
||||||
|
|
||||||
A short description of the addon, to be shown in lists and menus where the addon is shown aside others.
|
A short description of the addon, to be shown in lists and menus where the addon is shown aside others.
|
||||||
|
|
||||||
### website
|
### website
|
||||||
|
|
||||||
A URL to a website about the addon
|
A URL to a website about the addon
|
||||||
|
|
||||||
### source
|
### source
|
||||||
|
|
||||||
A URL to the source code of the addon.
|
A URL to the source code of the addon.
|
||||||
|
|
||||||
### issues
|
### issues
|
||||||
|
|
||||||
A URL to an issue tracker for the addon.
|
A URL to an issue tracker for the addon.
|
||||||
|
|
||||||
### contributors
|
### contributors
|
||||||
|
|
||||||
An array of people who have contributed to the addon.
|
An array of people who have contributed to the addon.
|
||||||
|
|
||||||
# Version Meta Object
|
# Version Meta Object
|
||||||
|
@ -66,7 +77,9 @@ An array of people who have contributed to the addon.
|
||||||
## Optional properties
|
## Optional properties
|
||||||
|
|
||||||
### changelog
|
### changelog
|
||||||
|
|
||||||
A path to a changelog file for the addon.
|
A path to a changelog file for the addon.
|
||||||
|
|
||||||
### timestamp
|
### timestamp
|
||||||
|
|
||||||
A unix timestamp of the time and date of the version's release.
|
A unix timestamp of the time and date of the version's release.
|
||||||
|
|
|
@ -19,6 +19,7 @@ This is the ID or namespaced ID of the addon this relation refers to.
|
||||||
### version
|
### version
|
||||||
|
|
||||||
<!--TODO: update link one PR is merged-->
|
<!--TODO: update link one PR is merged-->
|
||||||
|
|
||||||
This is a [semver version range](https://github.com/semver/semver/pull/584) of supported versions of this relation.
|
This is a [semver version range](https://github.com/semver/semver/pull/584) of supported versions of this relation.
|
||||||
|
|
||||||
## Optional properties
|
## Optional properties
|
||||||
|
|
|
@ -1,3 +1,3 @@
|
||||||
#!/bin/sh
|
#!/bin/sh
|
||||||
# Requires the prettier formatter. This should always be run before committing (looking at you, tilera!)
|
# Requires the prettier formatter. This should always be run before committing (looking at you, tilera!)
|
||||||
prettier --write ./**/*.md
|
prettier --write $(find -name "*.md")
|
||||||
|
|
Loading…
Reference in a new issue