more consistency/smoothing in the quickstart instructions

This commit is contained in:
matthew wall
2023-12-22 09:16:09 -05:00
parent e402cd4dee
commit 9d25cee13a
5 changed files with 57 additions and 64 deletions

View File

@@ -89,26 +89,25 @@ To enable uploads, or to enable other reports, modify the configuration file
sudo nano /etc/weewx/weewx.conf
```
See the [*User's Guide*](../usersguide/introduction.md) and the reference
[*The configuration file
weewx.conf*](../reference/weewx-options/introduction.md) for
instructions.
For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the [reference for skin
options](../reference/skin-options/introduction.md).
The reference
[*Application options*](../reference/weewx-options/introduction.md)
contains an extensive list of the configuration options, with explanations for
what they do. For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the reference [*Skin
options*](../reference/skin-options/introduction.md).
To install new skins, drivers, or other extensions, use the utility [`weectl
extension`](../utilities/weectl-extension.md).
To install new skins, drivers, or other extensions, use the [extension
utility](../utilities/weectl-extension.md).
WeeWX must be restarted for any changes to take effect.
WeeWX must be restarted for the changes to take effect.
```{.shell .copy}
sudo systemctl restart weewx
```
Consider putting yourself into the `weewx` group. When you are in the `weewx`
group, you can do many things without having to `sudo`, including modifying
the WeeWX configuration and installing extensions.
If you plan to do a lot of customization, consider putting yourself into the
`weewx` group. When you are in the `weewx` group, you can do many things
without having to `sudo`, including modifying the WeeWX configuration and
installing extensions.
```{.shell .copy}
sudo usermod -aG weewx $USER
```

View File

@@ -104,10 +104,10 @@ source ~/weewx-venv/bin/activate
python3 ~/weewx/src/weewxd.py
```
To run `weewxd` as a daemon, install a systemd or init file that is
appropriate for your operating system. Be sure to use the full path in the
virtual environment to the Python interpreter and `weewxd.py`. Examples are
included in the directory `~/weewx-data/util`.
To run `weewxd` as a daemon, install a systemd service unit or SysV init script
that is appropriate for your operating system. Be sure to use the full path to
the Python interpreter and `weewxd.py` - the paths in the virtual environment.
Examples are included in the directory `~/weewx-data/util`.
## Verify
@@ -138,17 +138,15 @@ To enable uploads, or to enable other reports, modify the configuration file
nano ~/weewx-data/weewx.conf
```
See the [*User's Guide*](../usersguide/introduction.md) and the reference
[*The configuration file
weewx.conf*](../reference/weewx-options/introduction.md) for
instructions.
For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the [reference for skin
options](../reference/skin-options/introduction.md).
The reference
[*Application options*](../reference/weewx-options/introduction.md)
contains an extensive list of the configuration options, with explanations for
what they do. For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the reference [*Skin
options*](../reference/skin-options/introduction.md).
To install new skins, drivers, or other extensions, use the utility [`weectl
extension`](../utilities/weectl-extension.md).
To install new skins, drivers, or other extensions, use the [extension
utility](../utilities/weectl-extension.md).
The executable `weewxd` must be restarted for the changes to take effect.

View File

@@ -303,17 +303,15 @@ To enable uploads, or to enable other reports, modify the configuration file
nano ~/weewx-data/weewx.conf
```
See the [*User's Guide*](../usersguide/introduction.md) and the reference
[*The configuration file
weewx.conf*](../reference/weewx-options/introduction.md) for
instructions.
For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the [reference for skin
options](../reference/skin-options/introduction.md).
The reference
[*Application options*](../reference/weewx-options/introduction.md)
contains an extensive list of the configuration options, with explanations for
what they do. For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the reference [*Skin
options*](../reference/skin-options/introduction.md).
To install new skins, drivers, or other extensions, use the utility [`weectl
extension`](../utilities/weectl-extension.md).
To install new skins, drivers, or other extensions, use the [extension
utility](../utilities/weectl-extension.md).
WeeWX must be restarted for the changes to take effect.

View File

@@ -91,26 +91,25 @@ To enable uploads, or to enable other reports, modify the configuration file
sudo nano /etc/weewx/weewx.conf
```
See the [*User's Guide*](../usersguide/introduction.md) and the reference
[*The configuration file
weewx.conf*](../reference/weewx-options/introduction.md) for
instructions.
For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the [reference for skin
options](../reference/skin-options/introduction.md).
The reference
[*Application options*](../reference/weewx-options/introduction.md)
contains an extensive list of the configuration options, with explanations for
what they do. For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the reference [*Skin
options*](../reference/skin-options/introduction.md).
To install new skins, drivers, or other extensions, use the utility [`weectl
extension`](../utilities/weectl-extension.md).
To install new skins, drivers, or other extensions, use the [extension
utility](../utilities/weectl-extension.md).
WeeWX must be restarted for the changes to take effect.
```{.shell .copy}
sudo systemctl restart weewx
```
Consider putting yourself into the `weewx` group. When you are in the `weewx`
group, you can do many things without having to `sudo`, including modifying
the WeeWX configuration and installing extensions.
If you plan to do a lot of customization, consider putting yourself into the
`weewx` group. When you are in the `weewx` group, you can do many things
without having to `sudo`, including modifying the WeeWX configuration and
installing extensions.
```{.shell .copy}
sudo usermod -aG weewx $USER
```

View File

@@ -83,26 +83,25 @@ To enable uploads, or to enable other reports, modify the configuration file
sudo nano /etc/weewx/weewx.conf
```
See the [*User's Guide*](../usersguide/introduction.md) and the reference
[*The configuration file
weewx.conf*](../reference/weewx-options/introduction.md) for
instructions.
For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the [reference for skin
options](../reference/skin-options/introduction.md).
The reference
[*Application options*](../reference/weewx-options/introduction.md)
contains an extensive list of the configuration options, with explanations for
what they do. For more advanced customization, see the [*Customization
Guide*](../custom/introduction.md), as well as the reference [*Skin
options*](../reference/skin-options/introduction.md).
To install new skins, drivers, or other extensions, use the utility [`weectl
extension`](../utilities/weectl-extension.md).
To install new skins, drivers, or other extensions, use the [extension
utility](../utilities/weectl-extension.md).
WeeWX must be restarted for the changes to take effect.
```{.shell .copy}
sudo systemctl restart weewx
```
Consider putting yourself into the `weewx` group. When you are in the `weewx`
group, you can do many things without having to `sudo`, including modifying
the WeeWX configuration and installing extensions.
If you plan to do a lot of customization, consider putting yourself into the
`weewx` group. When you are in the `weewx` group, you can do many things
without having to `sudo`, including modifying the WeeWX configuration and
installing extensions.
```{.shell .copy}
sudo usermod -aG weewx $USER
```