Skip to content

Latest commit

 

History

History
125 lines (76 loc) · 3.59 KB

README.md

File metadata and controls

125 lines (76 loc) · 3.59 KB
Raw

PyDOC

A Sublime Text 3 plugin that supports Python documentation search from selections in the editor.

About

PyDOC is a plugin for Sublime Text 3 that allows you to open current project documentation for:

  • Python 2
  • Python 3
  • Numpy
  • SciPy
  • Matplotlib
  • TensorFlow

using source selections in your text editor. The selected text is used as the query for the official documentation provided on docs.python.org and the respective package websites. The documentation is opened in your default web browser.

Install PyDOC

Using Sublime Package Control

PyDOC can be installed using Sublime Package Control. Open the command palette with:

Mac OSX
Cmd + Shift + P
Linux & Windows
Ctrl + Shift + P

Type install and select the menu item, Package Control: Install Package.

Type PyDOC and select the PyDOC package that is displayed. This will install the package in your editor.

Using Git

Use the Sublime Text menu items Preferences -> Browse Packages to locate your Packages directory.

Navigate to the directory in your terminal and clone the PyDOC source repository inside the Packages directory using the command:

$ git clone https://github.com/chrissimpkins/PyDOC.git

Manual Install

Download the zip compressed archive from GitHub.

Decompress the zip archive and rename the directory PyDOC.

Open your Sublime Text Packages directory using the Preferences -> Browse Packages menu items.

Move the entire PyDOC directory into your Sublime Text Packages directory.

Use PyDOC

Search with Right Click Menu

Select a built-in Python object in your editor text, then use the Python 2 Doc Search, Python 3 Doc Search, Numpy Doc Search, SciPy Doc Search, Matplotlib Doc Search, or TensorFlow Doc Search menu item in the right click menu.

Search with Keybinding

Select a built-in Python object in your editor text, then use one of the following keybindings to perform the search:

Python 2 Documentation Search Keybinding
Ctrl-2
Python 3 Documentation Search Keybinding
Ctrl-3
Numpy Documentation Search Keybinding
Ctrl-4
SciPy Documentation Search Keybinding
Ctrl-5
Matplotlib Documentation Search Keybinding
Ctrl-6
TensorFlow Documentation Search Keybinding
Ctrl-7

Search with the Command Palette

Select a built-in Python object in your editor text then enter the key binding to open the command palette (see description above in the Sublime Package Control section). Type 'pydoc' and then select either Python 2 Doc Search (PyDOC), Python 3 Doc Search (PyDOC),Numpy Doc Search (PyDOC), SciPy Doc Search (PyDOC), Matplotlib Doc Search (PyDOC), or TensorFlow Doc Search (PyDOC).

Issues

Having a problem? Let's fix it. Here are a few steps that will lead to the most rapid fix:

  1. Make sure that you selected text in the editor before attempting to use PyDOC. It's not that good (yet...).

  2. Open the Sublime Text console with Ctrl-` or View -> Show Console, then run PyDOC again. It generally provides helpful hints for problems and any exceptions that are raised will be displayed.

  3. Submit the issue on the GitHub repository with as much detail as you can provide. Please paste the console ouptut for any exceptions that are raised.

Changes

See CHANGELOG.md

License

MIT License