move media attachment section above status
This commit is contained in:
parent
b8b03748d7
commit
9a59f44c46
1 changed files with 62 additions and 62 deletions
124
docs/manual.md
124
docs/manual.md
|
@ -28,6 +28,10 @@
|
||||||
- [View your follow requests](#view-your-follow-requests)
|
- [View your follow requests](#view-your-follow-requests)
|
||||||
- [Accept a follow request](#accept-a-follow-request)
|
- [Accept a follow request](#accept-a-follow-request)
|
||||||
- [Reject a follow request](#reject-a-follow-request)
|
- [Reject a follow request](#reject-a-follow-request)
|
||||||
|
- [Media Attachments](#media-attachments)
|
||||||
|
- [Create a media attachment](#create-a-media-attachment)
|
||||||
|
- [Edit a media attachment](#edit-a-media-attachment)
|
||||||
|
- [View a media attachment](#view-a-media-attachment)
|
||||||
- [Statuses](#statuses)
|
- [Statuses](#statuses)
|
||||||
- [View a status](#view-a-status)
|
- [View a status](#view-a-status)
|
||||||
- [Create a status](#create-a-status)
|
- [Create a status](#create-a-status)
|
||||||
|
@ -54,10 +58,6 @@
|
||||||
- [Remove accounts from a list](#remove-accounts-from-a-list)
|
- [Remove accounts from a list](#remove-accounts-from-a-list)
|
||||||
- [Timelines](#timelines)
|
- [Timelines](#timelines)
|
||||||
- [View a timeline](#view-a-timeline)
|
- [View a timeline](#view-a-timeline)
|
||||||
- [Media Attachments](#media-attachments)
|
|
||||||
- [Create a media attachment](#create-a-media-attachment)
|
|
||||||
- [Edit a media attachment](#edit-a-media-attachment)
|
|
||||||
- [View a media attachment](#view-a-media-attachment)
|
|
||||||
- [Media](#media)
|
- [Media](#media)
|
||||||
- [View media from a status](#view-media-from-a-status)
|
- [View media from a status](#view-media-from-a-status)
|
||||||
- [Bookmarks](#bookmarks)
|
- [Bookmarks](#bookmarks)
|
||||||
|
@ -372,6 +372,64 @@ enbas reject --type follow-request --account-name @person.example.social
|
||||||
| `type` | string | true | The resource you want to accept.<br>Here this should be `follow-request`. | |
|
| `type` | string | true | The resource you want to accept.<br>Here this should be `follow-request`. | |
|
||||||
| `account-name` | string | true | The name of the account that you want to reject. | |
|
| `account-name` | string | true | The name of the account that you want to reject. | |
|
||||||
|
|
||||||
|
## Media Attachments
|
||||||
|
|
||||||
|
### Create a media attachment
|
||||||
|
|
||||||
|
Uploads media from a file to the instance and creates a media attachment.
|
||||||
|
You can write a description of the media to a text file and specify the its path with the `media-description` flag (see the examples below).
|
||||||
|
|
||||||
|
- Create a media attachment with a simple description and a focus of x=-0.1, y=0.5
|
||||||
|
```
|
||||||
|
enbas create --type media-attachment \
|
||||||
|
--media-file picture.png \
|
||||||
|
--media-description "A picture of an old, slanted wooden bench in front of the woods." \
|
||||||
|
--media-focus "-0.1,0.5"
|
||||||
|
```
|
||||||
|
- Create a media attachment using a description that has been written to the `description.txt` text file.
|
||||||
|
```
|
||||||
|
enbas create --type media-attachment \
|
||||||
|
--media-file picture.png \
|
||||||
|
--media-description file@description.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
| flag | type | required | description | default |
|
||||||
|
|------|------|----------|-------------|---------|
|
||||||
|
| `type` | string | true | The resource you want to create.<br>Here this should be `media-attachment`. | |
|
||||||
|
| `media-file` | string | true | The path to the media file. | |
|
||||||
|
| `media-description` | string | false | The description of the media attachment which will be used as the media's alt-text.<br>To use a description from a text file, use the `flag@` prefix followed by the path to the file (e.g. `file@description.txt`)| |
|
||||||
|
| `media-focus` | string | false | The media's focus values. This should be in the form of two comma-separated numbers between -1 and 1 (e.g. 0.25,-0.34) | |
|
||||||
|
|
||||||
|
### Edit a media attachment
|
||||||
|
|
||||||
|
Edits the description and/or the focus of a media attachment that you own.
|
||||||
|
|
||||||
|
```
|
||||||
|
enbas edit --type media-attachment \
|
||||||
|
--attachment-id 01J5B9A8WFK59W11MS6AHPYWBR \
|
||||||
|
--media-description "An updated description of a picture."
|
||||||
|
```
|
||||||
|
|
||||||
|
| flag | type | required | description | default |
|
||||||
|
|------|------|----------|-------------|---------|
|
||||||
|
| `type` | string | true | The resource you want to edit.<br>Here this should be `media-attachment`. | |
|
||||||
|
| `media-description` | string | false | The description of the media attachment to edit.<br>To use a description from a text file, use the `flag@` prefix followed by the path to the file (e.g. `file@description.txt`)| |
|
||||||
|
| `media-focus` | string | false | The media's focus values. This should be in the form of two comma-separated numbers between -1 and 1 (e.g. 0.25,-0.34) | |
|
||||||
|
|
||||||
|
### View a media attachment
|
||||||
|
|
||||||
|
Prints information about a given media attachment that you own.
|
||||||
|
You can only see information about the media attachment that you own.
|
||||||
|
|
||||||
|
```
|
||||||
|
enbas show --type media-attachment --attachment-id 01J0N0RQSJ7CFGKHA30F7GBQXT
|
||||||
|
```
|
||||||
|
|
||||||
|
| flag | type | required | description | default |
|
||||||
|
|------|------|----------|-------------|---------|
|
||||||
|
| `type` | string | true | The resource you want to view.<br>Here this should be `media`. | |
|
||||||
|
| `attachment-id` | string | true | The ID of the media attachment to view. | |
|
||||||
|
|
||||||
## Statuses
|
## Statuses
|
||||||
|
|
||||||
### View a status
|
### View a status
|
||||||
|
@ -706,64 +764,6 @@ Prints a list of statuses from a timeline.
|
||||||
| `tag` | string | false | The hashtag you want to view.<br>This is only required if `timeline-category` is set to `tag`. | |
|
| `tag` | string | false | The hashtag you want to view.<br>This is only required if `timeline-category` is set to `tag`. | |
|
||||||
| `limit` | integer | false | The maximum number of statuses to print. | 20 |
|
| `limit` | integer | false | The maximum number of statuses to print. | 20 |
|
||||||
|
|
||||||
## Media Attachments
|
|
||||||
|
|
||||||
### Create a media attachment
|
|
||||||
|
|
||||||
Uploads media from a file to the instance and creates a media attachment.
|
|
||||||
You can write a description of the media to a text file and specify the its path with the `media-description` flag (see the examples below).
|
|
||||||
|
|
||||||
- Create a media attachment with a simple description and a focus of x=-0.1, y=0.5
|
|
||||||
```
|
|
||||||
enbas create --type media-attachment \
|
|
||||||
--media-file picture.png \
|
|
||||||
--media-description "A picture of an old, slanted wooden bench in front of the woods." \
|
|
||||||
--media-focus "-0.1,0.5"
|
|
||||||
```
|
|
||||||
- Create a media attachment using a description that has been written to the `description.txt` text file.
|
|
||||||
```
|
|
||||||
enbas create --type media-attachment \
|
|
||||||
--media-file picture.png \
|
|
||||||
--media-description file@description.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
| flag | type | required | description | default |
|
|
||||||
|------|------|----------|-------------|---------|
|
|
||||||
| `type` | string | true | The resource you want to create.<br>Here this should be `media-attachment`. | |
|
|
||||||
| `media-file` | string | true | The path to the media file. | |
|
|
||||||
| `media-description` | string | false | The description of the media attachment which will be used as the media's alt-text.<br>To use a description from a text file, use the `flag@` prefix followed by the path to the file (e.g. `file@description.txt`)| |
|
|
||||||
| `media-focus` | string | false | The media's focus values. This should be in the form of two comma-separated numbers between -1 and 1 (e.g. 0.25,-0.34) | |
|
|
||||||
|
|
||||||
### Edit a media attachment
|
|
||||||
|
|
||||||
Edits the description and/or the focus of a media attachment that you own.
|
|
||||||
|
|
||||||
```
|
|
||||||
enbas edit --type media-attachment \
|
|
||||||
--attachment-id 01J5B9A8WFK59W11MS6AHPYWBR \
|
|
||||||
--media-description "An updated description of a picture."
|
|
||||||
```
|
|
||||||
|
|
||||||
| flag | type | required | description | default |
|
|
||||||
|------|------|----------|-------------|---------|
|
|
||||||
| `type` | string | true | The resource you want to edit.<br>Here this should be `media-attachment`. | |
|
|
||||||
| `media-description` | string | false | The description of the media attachment to edit.<br>To use a description from a text file, use the `flag@` prefix followed by the path to the file (e.g. `file@description.txt`)| |
|
|
||||||
| `media-focus` | string | false | The media's focus values. This should be in the form of two comma-separated numbers between -1 and 1 (e.g. 0.25,-0.34) | |
|
|
||||||
|
|
||||||
### View a media attachment
|
|
||||||
|
|
||||||
Prints information about a given media attachment that you own.
|
|
||||||
You can only see information about the media attachment that you own.
|
|
||||||
|
|
||||||
```
|
|
||||||
enbas show --type media-attachment --attachment-id 01J0N0RQSJ7CFGKHA30F7GBQXT
|
|
||||||
```
|
|
||||||
|
|
||||||
| flag | type | required | description | default |
|
|
||||||
|------|------|----------|-------------|---------|
|
|
||||||
| `type` | string | true | The resource you want to view.<br>Here this should be `media`. | |
|
|
||||||
| `attachment-id` | string | true | The ID of the media attachment to view. | |
|
|
||||||
|
|
||||||
## Media
|
## Media
|
||||||
|
|
||||||
### View media from a status
|
### View media from a status
|
||||||
|
|
Loading…
Reference in a new issue