checkpoint: writing getting started guide
This commit is contained in:
parent
c75c5ad3b2
commit
0509290e15
5 changed files with 35 additions and 3 deletions
|
@ -134,7 +134,7 @@ enbas show --type status --status-id 01HQE43KT5YEDN4RGMT7BC63PF
|
||||||
|
|
||||||
== Inspirations
|
== Inspirations
|
||||||
|
|
||||||
This project was inspired from the following projects:
|
This project was inspired by the following projects:
|
||||||
|
|
||||||
* **madonctl:** https://github.com/McKael/madonctl[A Mastodon CLI client written in Go.]
|
* **madonctl:** https://github.com/McKael/madonctl[A Mastodon CLI client written in Go.]
|
||||||
* **toot:** https://pypi.org/project/toot/[A Mastodon CLI and TUI written in Python.]
|
* **toot:** https://pypi.org/project/toot/[A Mastodon CLI and TUI written in Python.]
|
||||||
|
|
0
docs/changelog.md
Normal file
0
docs/changelog.md
Normal file
0
docs/cheatsheet.md
Normal file
0
docs/cheatsheet.md
Normal file
30
docs/getting-started.md
Normal file
30
docs/getting-started.md
Normal file
|
@ -0,0 +1,30 @@
|
||||||
|
# Getting Started
|
||||||
|
|
||||||
|
## Summary
|
||||||
|
|
||||||
|
In this guide we are going to log into an account on a private GoToSocial server.
|
||||||
|
Follow along to log into your own account.
|
||||||
|
|
||||||
|
## Your configuration directory
|
||||||
|
|
||||||
|
Enbas uses Go's [os.UserConfigDir()](https://pkg.go.dev/os#UserConfigDir) function to calculate the location of your configuration directory.
|
||||||
|
|
||||||
|
If you've set the `XDG_CONFIG_HOME` environment variable, the configuration directory will be set to `$XDG_CONFIG_HOME/enbas`.
|
||||||
|
|
||||||
|
If this is not set, then:
|
||||||
|
|
||||||
|
- on Linux the configuration directory will be set to `$HOME/.config/enbas`.
|
||||||
|
- on Darwin (MacOS) the configuration directory will be set to `$HOME/Library/Application Support/enbas`.
|
||||||
|
- on Windows the configuration directory will be set within the `%AppData%` directory.
|
||||||
|
|
||||||
|
Alternatively you can use the `--config-dir` global flag to specify your configuration directory.
|
||||||
|
|
||||||
|
## Generate your configuration file
|
||||||
|
|
||||||
|
Run `enbas init` to generate your configuration file.
|
||||||
|
|
||||||
|
View configuration file. JSON file, mostly blank slate for you to configure to your preferences. Configuration documentation coming soon. For this getting started guide you may want to specify your preferred browser to open the link to your instance's login page. Can leave blank if you prefer to open the link manually.
|
||||||
|
|
||||||
|
## Log into your GoToSocial account
|
||||||
|
|
||||||
|
## View your account information
|
|
@ -35,7 +35,7 @@ ENBAS_INSTALL_PREFIX=${HOME}/.local mage install
|
||||||
|
|
||||||
This will install Enbas to `~/.local/bin/enbas`.
|
This will install Enbas to `~/.local/bin/enbas`.
|
||||||
|
|
||||||
===== Environment variables you can use with Mage
|
The table below shows all the environment variables you can use when building with Mage.
|
||||||
|
|
||||||
| Environment Variable | Description |
|
| Environment Variable | Description |
|
||||||
|--------------------------|------------------------------------------------------------------------------|
|
|--------------------------|------------------------------------------------------------------------------|
|
||||||
|
@ -53,7 +53,7 @@ cd enbas
|
||||||
go install ./cmd/enbas
|
go install ./cmd/enbas
|
||||||
```
|
```
|
||||||
|
|
||||||
### Verify the installation
|
## Verify the installation
|
||||||
|
|
||||||
Type `enbas` from your terminal to verify that the installation was successful. You should see the help documentation.
|
Type `enbas` from your terminal to verify that the installation was successful. You should see the help documentation.
|
||||||
|
|
||||||
|
@ -113,3 +113,5 @@ Git commit: c8892a6
|
||||||
Go version: go1.22.4
|
Go version: go1.22.4
|
||||||
Build date: 2024-06-28T21:57:37Z
|
Build date: 2024-06-28T21:57:37Z
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Once you have completed the installation proceed to the [Getting Started guide](./getting-started.md).
|
||||||
|
|
Loading…
Reference in a new issue