Merge pull request #383 from yuya-oc/linux-readme
Add simple README for Linux packages Close #376
This commit is contained in:
@@ -76,7 +76,7 @@
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
"from": "resources/linux",
|
"from": "resources/linux",
|
||||||
"filter": "create_desktop_file.sh"
|
"filter": ["create_desktop_file.sh", "README.md"]
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
69
resources/linux/README.md
Normal file
69
resources/linux/README.md
Normal file
@@ -0,0 +1,69 @@
|
|||||||
|
# Mattermost Desktop for Linux
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Install](#install)
|
||||||
|
- [User Guide](#user-guide)
|
||||||
|
- [Contributing](#contributing)
|
||||||
|
- [License](#license)
|
||||||
|
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
If you installed the application via a package manager, it's ready to use in your system. Please follow the [User Guide](#user-guide) for further information.
|
||||||
|
|
||||||
|
Otherwise, first locate the extracted directory in your desired directory (e.g. `/opt/mattermost-desktop-<VERSION>`) and follow the steps below.
|
||||||
|
|
||||||
|
### Desktop launcher
|
||||||
|
|
||||||
|
Execute the script file to create a `Mattermost.desktop` file.
|
||||||
|
|
||||||
|
```
|
||||||
|
/opt/mattermost-desktop-<VERSION>/create_desktop_file.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Then move it to the appropriate directory of your desktop environment. For example, on Ubuntu Unity it's `~/.local/share/applications/` for the current user.
|
||||||
|
|
||||||
|
```
|
||||||
|
mv Mattermost.desktop ~/.local/share/applications/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Terminal command
|
||||||
|
|
||||||
|
Set a `PATH` environment variable to enable launching from the terminal. For example, you can append the following line into `~/.bashrc`.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
# assuming that /opt/mattermost-desktop-<VERSION>/mattermost-desktop is the executable file.
|
||||||
|
export PATH=$PATH:/opt/mattermost-desktop-<VERSION>
|
||||||
|
```
|
||||||
|
|
||||||
|
Alternatively, you can also create a symbolic link for the application.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo ln -s /opt/mattermost-desktop-<VERSION>/mattermost-desktop /usr/local/bin/
|
||||||
|
```
|
||||||
|
|
||||||
|
You're now all set! See the [User Guide](#user-guide) below for instructions.
|
||||||
|
|
||||||
|
|
||||||
|
## User Guide
|
||||||
|
|
||||||
|
After launching, you need to configure the application to interact with your team.
|
||||||
|
|
||||||
|
1. If you don't see a page titled "Settings", select **File** > **Settings...** from the menu bar.
|
||||||
|
2. Click **Add new team** next to the right of Team Management section.
|
||||||
|
3. Enter **Name** and a valid **URL**, which begins with either `http://` or `https://`.
|
||||||
|
4. Click **Add**.
|
||||||
|
5. Click **Save**.
|
||||||
|
|
||||||
|
More guides are available at [Mattermost Documentation](https://docs.mattermost.com/help/apps/desktop-guide.html).
|
||||||
|
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
See [contributing guidelines](https://github.com/mattermost/desktop/blob/master/CONTRIBUTING.md) for reporting bugs, features or submitting pull requests.
|
||||||
|
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
Apache License, Version 2.0
|
Reference in New Issue
Block a user