docs: update installation instructions for lektor/lektor#1104

This commit is contained in:
Jeff Dairiki 2023-04-17 20:50:08 -07:00
parent fa73e1db27
commit 59f7b0f1f9
1 changed files with 15 additions and 9 deletions

View File

@ -12,25 +12,22 @@ issues.
## Requirements ## Requirements
Although `lektor` would work without Imagemagick or FFmpeg, you would be missing on Although `lektor` would work without FFmpeg, you would be missing on
significant parts of its capabilities. Therefore, you need to make sure you have the some of its capabilities. Therefore, you need to make sure you have the
following software installed on your computer: following software installed on your computer:
* Python 3.6+ is required. If you got an older version, look at the * Python 3.7+ is required. If you got an older version, look at the
[Python 3 Installation & Setup Guide :ext](https://realpython.com/installing-python/). [Python 3 Installation & Setup Guide :ext](https://realpython.com/installing-python/).
* On Ubuntu you basically don't need anything new. * On Ubuntu you basically don't need anything new.
* On macOS you're done as well. * On macOS you're done as well.
* On Windows, make sure that Python is in your `PATH`. * On Windows, make sure that Python is in your `PATH`.
* ImageMagick. * FFmpeg (optional, for video thumbnailing support).
* On macOS `brew install imagemagick` can get you this.
* On Ubuntu `sudo apt install imagemagick` will solve it.
* On Windows do `choco install imagemagick`, which requires [chocolatey :ext](https://chocolatey.org/),
or [download from here :ext](http://www.imagemagick.org)).
* FFmpeg (mostly for video thumbnailing).
* On Ubuntu you get it through `sudo apt install ffmpeg.` * On Ubuntu you get it through `sudo apt install ffmpeg.`
* On macOS `brew install ffmpeg` will do the trick. * On macOS `brew install ffmpeg` will do the trick.
* On Windows you'll have to put a little [work :ext](https://www.wikihow.com/Install-FFmpeg-on-Windows) in. * On Windows you'll have to put a little [work :ext](https://www.wikihow.com/Install-FFmpeg-on-Windows) in.
! Since release 3.4.0, Lektor uses [Pillow :ext](https://pillow.readthedocs.io/) for image thumbnailing. ImageMagick is no longer required.
## Install pipx ## Install pipx
Once you have those installed and have made sure that they are on your `PATH`, you can Once you have those installed and have made sure that they are on your `PATH`, you can
@ -99,3 +96,12 @@ virtualenv venv
. venv/bin/activate . venv/bin/activate
pip install --editable . pip install --editable .
``` ```
Recent versions of Lektor (since around 3.4.0) are also installable directly from git.
You still need `npm` installed, but the frontend JS will be built automatically as part of the PEP 517 build process:
```
python -m venv venv
./venv/bin/pip install "lektor @ git+https://github.com/lektor/lektor@master"
```