|
1 | | -<!-- |
2 | | -π Hello! As Nova users browse the extensions library, a good README can help them understand what your extension does, how it works, and what setup or configuration it may require. |
| 1 | +# Ruby Gems Extension for Panic's Nova Code Editor |
3 | 2 |
|
4 | | -Not every extension will need every item described below. Use your best judgement when deciding which parts to keep to provide the best experience for your new users. |
| 3 | +Provides a sidebar with information on gems contained in a project's Gemfile using RubyGems.org. Built for Panic's macOS code editor, Nova. |
5 | 4 |
|
6 | | -π‘ Quick Tip!Β As you edit this README template, you can preview your changes by selecting **Extensions β Activate Project as Extension**, opening the Extension Library, and selecting "ruby-gems" in the sidebar. |
| 5 | +<img src="https://user-images.githubusercontent.com/48892071/127221251-14cc14d3-e45d-4e1b-ac31-341ff007474e.png" width="800" alt="Ruby Gems Nova Extension Screenshot"> |
7 | 6 |
|
8 | | -Let's get started! |
9 | | ---> |
| 7 | +Thank you to RubyGems.org and its contributors! *This extension is not created, maintained, or endorsed by RubyGems.org. To request features or report bugs, please see the section below.* |
10 | 8 |
|
11 | | -<!-- |
12 | | -π Include a brief description of the features your extension provides. For example: |
13 | | ---> |
| 9 | +## Prerequisites |
14 | 10 |
|
15 | | -**ruby-gems** provides sidebar integration with **A Helpful Tool**, including the most important feature, something that's really helpful, and _a little-known secret!_ |
16 | | - |
17 | | -<!-- |
18 | | -π It can also be helpful to include a screenshot or GIF showing your extension in action: |
19 | | ---> |
20 | | - |
21 | | - |
22 | | - |
23 | | -## Requirements |
24 | | - |
25 | | -<!-- |
26 | | -π If your extension depends on external processes or tools that users will need to have, it's helpful to list those and provide links to their installers: |
27 | | ---> |
28 | | - |
29 | | -ruby-gems requires some additional tools to be installed on your Mac: |
30 | | - |
31 | | -- [Node.js 8.2.0](https://nodejs.org) and NPM 5.2.0 or newer |
32 | | - |
33 | | -<!-- |
34 | | -β¨ Providing tips, tricks, or other guides for installing or configuring external dependencies can go a long way toward helping your users have a good setup experience: |
35 | | ---> |
36 | | - |
37 | | -> To install the current stable version of Node, click the "Recommended for Most Users" button to begin the download. When that completes, double-click the **.pkg** installer to begin installation. |
| 11 | +There are no prerequisites for this extension. |
38 | 12 |
|
39 | 13 | ## Usage |
40 | 14 |
|
41 | | -<!-- |
42 | | -π If your extension provides features that are invoked manually, consider describing those options for users: |
43 | | ---> |
44 | | - |
45 | | -To run ruby-gems: |
46 | | - |
47 | | -- Select the **Editor β ruby-gems** menu item; or |
48 | | -- Open the command palette and type `ruby-gems` |
| 15 | +Enable the extension in the extension library within Nova. |
49 | 16 |
|
50 | | -<!-- |
51 | | -π Alternatively, if your extension runs automatically (as in the case of a validator), consider showing users what they can expect to see. |
52 | | ---> |
| 17 | +<img src="https://user-images.githubusercontent.com/48892071/127221912-3abb50a1-036d-4cae-86cf-67dd9831e461.png" width="800" alt="Ruby Gems Nova Extension Screenshot"> |
53 | 18 |
|
54 | | -### Configuration |
| 19 | +## Configuration |
55 | 20 |
|
56 | | -<!-- |
57 | | -π If your extension offers global- or workspace-scoped preferences, consider pointing users toward those settings. For example: |
58 | | ---> |
| 21 | +The Ruby Gems extension will search for a 'Gemfile' in the root directory of the project unless a 'Gemfile' location is specified in the workspace preferences. |
59 | 22 |
|
60 | | -To configure global preferences, open **Extensions β Extension Library...** then select ruby-gems's **Preferences** tab. |
| 23 | +### Workspace Configuration |
| 24 | +To specify a 'Gemfile' location, go to the workspace preferences, select Ruby Gems, and choose a file. Simply delete the path if you wish to for the extension to automatically find and include the default 'Gemfile' from the root directory again. |
61 | 25 |
|
62 | | -You can also configure preferences on a per-project basis in **Project β Project Settings...** |
| 26 | +<img src="https://user-images.githubusercontent.com/48892071/127221966-22bd9c96-60cf-46eb-878e-22dbf3b31b67.png" width="800" alt="Ruby Gems Workspace Preferences"> |
63 | 27 |
|
64 | | -<!-- |
65 | | -π That's it! Happy developing! |
| 28 | +## Report a Bug or Feature Request |
66 | 29 |
|
67 | | -P.S. If you'd like, you can remove these comments before submitting your extension π |
68 | | ---> |
| 30 | +To report a bug or request a feature, please add an issue to the GitHub repository. Thanks! |
0 commit comments