Updated README: Installation, Deprecated CLI Tools
* The installation instructions were extended to cover the cases where pip was (willingly or not) used with the --user flag. See issue #36 were this came up. * The use of brother_ql_{create,print,debug,analyze,info} is now considered deprecated. * Furthermore: wording on brother_ql_web improved
This commit is contained in:
@@ -21,9 +21,8 @@ The new QL-800 series can print labels with two colors (black and red) on DK-222
|
|||||||
Note: If your printer has an 'Editor Lite' mode, you need to disable it if you want to print via USB.
|
Note: If your printer has an 'Editor Lite' mode, you need to disable it if you want to print via USB.
|
||||||
Make sure that the corresponding LED is not lit by holding the button down until it turns off.
|
Make sure that the corresponding LED is not lit by holding the button down until it turns off.
|
||||||
|
|
||||||
If you're interested in printing labels using a web interface, have a look at my project
|
If you're interested in printing labels using a web interface, check out [brother\_ql\_web][],
|
||||||
[brother\_ql\_web][].
|
which builds upon this package.
|
||||||
It makes use of the brother\_ql package and is also written in Python.
|
|
||||||
|
|
||||||
## Why
|
## Why
|
||||||
|
|
||||||
@@ -40,19 +39,26 @@ This is where brother\_ql comes into the game.
|
|||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
brother\_ql is available from PyPI with pip:
|
brother\_ql is [available on the Python Package Index][PyPI] to be installed with pip:
|
||||||
|
|
||||||
pip install brother_ql
|
|
||||||
# or to upgrade to a newer release:
|
|
||||||
pip install --upgrade brother_ql
|
pip install --upgrade brother_ql
|
||||||
|
|
||||||
Alternatively, you can install the latest development version from Github using:
|
The upgrade flag makes sure, you get the latest version of brother\_ql but also
|
||||||
|
of its dependencies.
|
||||||
|
|
||||||
|
Alternatively, you can install the latest version from Github using:
|
||||||
|
|
||||||
pip install --upgrade https://github.com/pklaus/brother_ql/archive/master.zip
|
pip install --upgrade https://github.com/pklaus/brother_ql/archive/master.zip
|
||||||
|
|
||||||
This package was mainly created for use with Python 3.
|
This package was mainly created for use with Python 3.
|
||||||
The essential functionality, however, will also work with Python 2: the creation of label files.
|
The essential functionality, however, will also work with Python 2: the creation of label files.
|
||||||
|
|
||||||
|
In order to run the `brother_ql` command line utility, the directory it resides in
|
||||||
|
needs to be in the PATH envirnoment variable.
|
||||||
|
On some systems, the `pip install` command defaults to the `--user` flag resulting in the utility
|
||||||
|
being put in the `~/.local/bin` directory.
|
||||||
|
On those systems, extending the path variable via `export PATH="${PATH}:~/.local/bin"` is needed.
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
The main user interface of this package is the command line tool `brother_ql`.
|
The main user interface of this package is the command line tool `brother_ql`.
|
||||||
@@ -163,8 +169,9 @@ it will be scaled to fit the width.
|
|||||||
|
|
||||||
For a long time, this project provided multiple command line tools, such as
|
For a long time, this project provided multiple command line tools, such as
|
||||||
`brother_ql_create`, `brother_ql_print`, `brother_ql_analyze`, and more.
|
`brother_ql_create`, `brother_ql_print`, `brother_ql_analyze`, and more.
|
||||||
A documentation of their usage can be found in the
|
The overview of those tools can still be found in the [LEGACY][] documentation.
|
||||||
[LEGACY][].
|
The use of these tools is now considered deprecated and they will be
|
||||||
|
removed in a future release.
|
||||||
|
|
||||||
## Author
|
## Author
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user