9ed0d772da
The link is created with docs in it, even if the mkdocs.yml file mentions doc as the documentation folder. I am not aware if there is any other dependency in the name doc, I have renamed it to docs and changed it also in the mkdocs.yml file. It seems docs is hardcoded in the readthedocs theme :(
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# Prelude Python
|
|
|
|
!!! Note
|
|
|
|
This module builds on top of the shared [Programming](programming.md) module.
|
|
|
|
## Python Mode
|
|
|
|
Emacs comes with Python programming support through the built-in
|
|
`python-mode`. Whenever you are editing Python code run `C-h m` to
|
|
look at the Python mode key bindings. Alternatively look at the
|
|
menu bar entries under Python. To toggle the menu bar press `F12`.
|
|
|
|
## Anaconda Mode
|
|
|
|
Prelude bundles the powerful
|
|
[anaconda-mode](https://github.com/pythonic-emacs/anaconda-mode),
|
|
which provides code navigation, documentation lookup and completion for Python.
|
|
|
|
Anaconda has integration with popular modes like `company` and `eldoc`.
|
|
|
|
## Syntax checking
|
|
|
|
Prelude ships with [Flycheck](https://github.com/flycheck/flycheck),
|
|
an on the fly syntax checker. Flycheck has support for two Python
|
|
syntax checkers, [Pylint](http://www.pylint.org/) and
|
|
[Flake8](http://flake8.readthedocs.org/en/latest/). In
|
|
order to have Flycheck support on the fly syntax checking for
|
|
Python you need to have either of these installed and accessible to
|
|
Emacs. In order to manually choose a checker run `C-c ! s`.
|
|
|
|
## Automatic insertion of file encoding comments
|
|
|
|
You can have Prelude auto-detect the encoding of a source buffer and
|
|
insert the appropriate `# coding:` comments. If you wish to enable
|
|
this, add the following to your configuration:
|
|
|
|
```emacs-lisp
|
|
(setq prelude-python-mode-set-encoding-automatically t)
|
|
```
|
|
|
|
!!! Note
|
|
|
|
Previously `prelude-python` had this feature enabled by default (up to Prelude 1.1), but
|
|
it is only necessary on Python 2, because Python 3 uses utf-8
|
|
as the default file encoding. In 2020 Python 2 became deprecated, so that
|
|
functionality became mostly obsolete.
|