mirror of
https://github.com/python-telegram-bot/python-telegram-bot.git
synced 2024-11-21 22:56:38 +01:00
Updated Home (markdown)
Bibo-Joshi
parent
42d107a4c8
commit
0fd4adba04
1 changed files with 33 additions and 58 deletions
91
Home.md
91
Home.md
|
|
@ -1,72 +1,47 @@
|
||||||
[](https://python-telegram-bot.org/)
|
[](https://python-telegram-bot.org/)
|
||||||
|
|
||||||
## PTB Resources
|
# Working with PTB
|
||||||
|
|
||||||
PTB offers different resources that help you understand and use the features of the library.
|
## Quick Start
|
||||||
|
|
||||||
- The [package documentation][] is the technical reference for
|
Our Wiki (where you currently are) contains an [Introduction to the API](https://github.com/python-telegram-bot/python-telegram-bot/wiki/Introduction-to-the-API) explaining how the pure Bot API can be accessed via `python-telegram-bot`.
|
||||||
`python-telegram-bot`. It contains descriptions of all available
|
Moreover, the [Tutorial: Your first Bot](https://github.com/python-telegram-bot/python-telegram-bot/wiki/Extensions---Your-first-Bot) gives an Introduction on how chatbots can be easily programmed with the help of the `telegram.ext` module.
|
||||||
classes, modules, methods and arguments.
|
|
||||||
- This [wiki][] is home to number of more elaborate introductions of
|
|
||||||
the different features of `python-telegram-bot` and other useful
|
|
||||||
resources that go beyond the technical documentation.
|
|
||||||
- Our [examples directory][] contains several examples that showcase
|
|
||||||
the different features of both the Bot API and
|
|
||||||
`python-telegram-bot`. Even if it is not your approach for learning,
|
|
||||||
please take a look at [`echobot.py`](https://docs.python-telegram-bot.org/en/stable/examples.echobot.html). It is the de facto base for most
|
|
||||||
of the bots out there. The code for these examples is released to
|
|
||||||
the public domain, so you can start by grabbing the code and
|
|
||||||
building on top of it.
|
|
||||||
- The [official Telegram Bot API documentation][] is of course always
|
|
||||||
worth a read.
|
|
||||||
|
|
||||||
|
## Resources
|
||||||
|
|
||||||
[package documentation]: https://python-telegram-bot.readthedocs.io/
|
- The [package documentation](https://docs.python-telegram-bot.org/) is the technical reference for `python-telegram-bot`.
|
||||||
[wiki]: https://github.com/python-telegram-bot/python-telegram-bot/wiki/
|
It contains descriptions of all available classes, modules, methods and arguments as well as the [changelog](https://docs.python-telegram-bot.org/changelog.html).
|
||||||
[examples directory]: https://docs.python-telegram-bot.org/examples.html
|
- The [wiki](https://github.com/python-telegram-bot/python-telegram-bot/wiki/) is home to number of more elaborate introductions of the different features of `python-telegram-bot` and other useful resources that go beyond the technical documentation.
|
||||||
[official Telegram Bot API documentation]: https://core.telegram.org/bots/api
|
See [below](#structure-of-this-wiki) for more details on what this wiki contains.
|
||||||
|
- Our [examples section](https://docs.python-telegram-bot.org/examples.html) contains several examples that showcase the different features of both the Bot API and `python-telegram-bot`.
|
||||||
|
Even if it is not your approach for learning, please take a look at `echobot.py`.
|
||||||
|
It is the de facto base for most of the bots out there.
|
||||||
|
The code for these examples is released to the public domain, so you can start by grabbing the code and building on top of it.
|
||||||
|
- The [official Telegram Bot API documentation](https://core.telegram.org/bots/api) is of course always worth a read.
|
||||||
|
|
||||||
|
## Getting help
|
||||||
|
|
||||||
## Contributing to this Wiki
|
If the resources mentioned above don't answer your questions or simply overwhelm you, there are several ways of getting help.
|
||||||
If you stumble upon a part of the wiki that is unclear or missing important points, please go ahead and drop us a message in our [Telegram Group](https://t.me/pythontelegrambotgroup), or just edit the part yourself (anyone can contribute). We'd like our wiki to be as complete as possible 🙂
|
|
||||||
|
1. We have a vibrant community of developers helping each other in our [Telegram group](https://telegram.me/pythontelegrambotgroup).
|
||||||
|
Join us! Asking a question here is often the quickest way to get a pointer in the right direction.
|
||||||
|
2. Ask questions by opening [a discussion](https://github.com/python-telegram-bot/python-telegram-bot/discussions/new).
|
||||||
|
3. You can even ask for help on Stack Overflow using the [python-telegram-bot tag](https://stackoverflow.com/questions/tagged/python-telegram-bot).
|
||||||
|
|
||||||
## Structure of this Wiki
|
## Structure of this Wiki
|
||||||
|
|
||||||
In the sidebar to the right, you can find all important pages of this wiki. They are roughly organized by the following logic:
|
In the sidebar to the right, you can find all important pages of this wiki. They are roughly organized by the following logic:
|
||||||
|
|
||||||
### Must read
|
* **Must read:** Introductory articles and frequently referenced pages.
|
||||||
|
* **Concepts & Important Elements:** Introductions & explanations of how the components of `telegram.ext` work and interact with each other.
|
||||||
|
* **Notable Features:** Elaborate explanation to more advanced features of `telegram.ext`.
|
||||||
|
* **Code Resources:** Some other resources that are not exclusively PTB-specific.
|
||||||
|
* **Examples Explained:** An effort to make the [examples](https://github.com/python-telegram-bot/python-telegram-bot/tree/master/examples) even more accessible.
|
||||||
|
*You are very welcome to extend this section!*
|
||||||
|
* **Networking:** Articles about advanced networking questions.
|
||||||
|
* **Other resources:** More interesting & helpful stuff that can't be found in any of the above sections.
|
||||||
|
* **Transition Guides:** Major versions usually come with breaking changes, i.e. changes that lead to code failing after upgrading. Those guides help to ease the transition.
|
||||||
|
* **Administration:** Interesting mostly for the maintainers. They, too, need a place to take notes 🙂
|
||||||
|
|
||||||
Introductory articles and frequently referenced pages.
|
## Contributing to this Wiki
|
||||||
|
If you stumble upon a part of the wiki that is unclear or missing important points, please go ahead and drop us a message in our [Telegram Group](https://t.me/pythontelegrambotgroup), or just edit the part yourself (anyone can contribute). We'd like our wiki to be as complete as possible 🙂
|
||||||
### Concepts & Important Elements
|
|
||||||
|
|
||||||
Introductions & explanations of how the components of `telegram.ext` work and interact with each other.
|
|
||||||
|
|
||||||
### Notable Features
|
|
||||||
|
|
||||||
Elaborate explanation to more advanced features of `telegram.ext`.
|
|
||||||
|
|
||||||
### Code Resources
|
|
||||||
|
|
||||||
Some other resources that are not exclusively PTB-specific.
|
|
||||||
|
|
||||||
### Examples Explained
|
|
||||||
|
|
||||||
An effort to make the [examples](https://github.com/python-telegram-bot/python-telegram-bot/tree/master/examples) even more accessible.
|
|
||||||
*You are very welcome to extend this section!*
|
|
||||||
|
|
||||||
### Networking
|
|
||||||
|
|
||||||
Articles about advanced networking questions.
|
|
||||||
|
|
||||||
### Other resources
|
|
||||||
|
|
||||||
More interesting & helpful stuff that can't be found in any of the above sections.
|
|
||||||
|
|
||||||
### Transition Guides
|
|
||||||
|
|
||||||
Major versions usually come with breaking changes, i.e. changes that lead to code failing after upgrading. Those guides help to ease the transition.
|
|
||||||
|
|
||||||
### Administration
|
|
||||||
|
|
||||||
Interesting mostly for the maintainers. They, too, need a place to take notes 🙂
|
|
||||||
Loading…
Reference in a new issue