Git Product home page Git Product logo

ulauncher-devdocs's Introduction

ulauncher-devdocs

Build Status GitHub license

Ulauncher extension to search documentation on DevDocs

Demo

demo.gif

Requirements

  • Ulauncher >5
  • Python >= 3

Install

Open ulauncher preferences window -> extensions -> add extension and paste the following url:

https://github.com/brpaz/ulauncher-devdocs

Usage

Basic configuration

The first thing you need to do is to Open Extension preferences and configure the "List of Documentation to Download". The value of this input needs to be a valid JSON array containing the "slug" of the documentation pages you want to download. You can get the "slug" by opening the desired documentation page in your browser and look at the value in the url.

Note This is only for first level documentation.

After configuring your documentation preferences, the extension will start downloading the documentation in background. (it might take some time, depending on the number of documentations to download). You will receive a notification when the index process finish.

You can then start searching Documentation from ulauncher using "docs" keyword.

Specific keywords.

Instead of using "docs" as keyword for everything, you can specify specific keywords for each programming language. You can configure them in manifest.json file.

Ex:

 {
      "id": "ruby",
      "type": "keyword",
      "name": "ruby",
      "default_value": "ruby~2.5"
},

Note The keyword id and name can be whatever you want, but the default value should match a existing language slug.

Configure how to open DevDocs

  • The default configuration will open the documentation on the default browser. You can change it to open in Hawkeye or with the custom DevDocs protocol. This will allow opening directly on DevDocs-desktop after this PR is merged.

Development

git clone https://github.com/brpaz/ulauncher-devdocs
make link

The make link command will symlink the cloned repo into the appropriate location on the ulauncher extensions folder.

To see your changes, stop ulauncher and run it from the command line with: ulauncher -v.

Contributing

Contributions, issues and Features requests are welcome.

Show your support

Buy Me A Coffee

License

Copywright @ 2019 Bruno Paz

This project is MIT Licensed.

ulauncher-devdocs's People

Contributors

brpaz avatar renanmac avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

ulauncher-devdocs's Issues

KeyError

Ulancher V5.3.0~beta1

Not sure what is going on here. I've installed this extension on another computer without any trouble. Even modified it for the languages I needed. I also have your encoder extension installed on both machines.

I do notice that you can't easily edit the languages line inside the extension dialog easily. If you try to edit the text, you can type one character and then the cursor will move to the end of the line. I just copied the line and edited it in my text editor and pasted it back. Don't think this had anything to do with it as I also tried removing and reinstalling and still same error on this machine.

Message: 'com.github.brpaz.ulauncher-devdocs'
Error Name: UnhandledError
Type: KeyError

Stacktrace:

Traceback (most recent call last):
  File "/usr/lib/python3.7/site-packages/ulauncher/ui/windows/PreferencesUlauncherDialog.py", line 192, in on_scheme_callback
    resp = rt.dispatch(self, scheme_request.get_uri())
  File "/usr/lib/python3.7/site-packages/ulauncher/utils/Router.py", line 49, in dispatch
    return callback(context, url_params)
  File "/usr/lib/python3.7/site-packages/ulauncher/ui/windows/PreferencesUlauncherDialog.py", line 411, in prefs_extension_update_prefs
    controller = ExtensionServer.get_instance().get_controller(ext_id)
  File "/usr/lib/python3.7/site-packages/ulauncher/api/server/ExtensionServer.py", line 76, in get_controller
    return self.controllers[extension_id]
KeyError: 'com.github.brpaz.ulauncher-devdocs'

Thanks

js keyword is acting like docs

I've changed the javascript keyword to js.
Bildschirmfoto vom 2019-11-07 12-26-12

now it acts like the docs key word:
Bildschirmfoto vom 2019-11-07 12-28-49

Ulauncher: 5.4.0
ulauncher-devdocs: current

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.