Skip to content

Commit

Permalink
Feature(mdEditor): Auto-prompt extension install
Browse files Browse the repository at this point in the history
mdEditor will now ask if you want to install the recommended extensions.
the prompt should appear when entering the workplace after install.
if you already have them, don't worry, that's is why nothing showed up.
  • Loading branch information
killshot13 committed Jun 28, 2021
1 parent 7f50e90 commit 5898c7c
Show file tree
Hide file tree
Showing 4 changed files with 20 additions and 58 deletions.
11 changes: 0 additions & 11 deletions .devcontainer/Dockerfile

This file was deleted.

30 changes: 0 additions & 30 deletions .devcontainer/devcontainer.json

This file was deleted.

2 changes: 1 addition & 1 deletion .vscode/extensions.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
"recommendations": ["davidanson.vscode-markdownlint"]
"recommendations": ["davidanson.vscode-markdownlint", "DougFinke.vscode-pandoc"]
}
35 changes: 19 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@
>
> **v3.1.0**

## Table of Contents

- [About](#about)
Expand Down Expand Up @@ -48,49 +47,53 @@ mdEditor is an adaptation derived from the brainchild of [Dave Johnson](https://

## Prerequisites <a name = "prerequisites"></a>

#### [Visual Studio Code](https://code.visualstudio.com/Download)

**[Visual Studio Code](https://code.visualstudio.com/Download)**
This should be self-explanantory.

#### [Pandoc](http://pandoc.org/installing.html)

**[Pandoc](http://pandoc.org/installing.html)**
This may require some guidance if you don't currently use Pandoc. I wrote a gist to help first-time users; here is [the link](https://gist.github.com/killshot13/5b379355d275e79a5cb1f03c841c7d53).

### Installation <a name = "installation"></a>

Decide where the core mdEditor files should live on your local drive (reference [About](#about) for more), then clone [mdEditor](https://github.com/killshot13/mdEditor.git) to that location.

Now, open mdEditor at the base directory using VSCode. Your IDE will auto-discover the `.code-workspace` file and prompt you to reopen the folder as a workspace. Confirm this choice, unless you wish to use a different configuration.

If so, there is a blank `settings.json` in the `.vscode` folder for you. Otherwise, you should disregard said folder completely.

We still need to pass the linting rulebook and Pandoc style guide to the editor workspace.

Let's install these VSCode extensions, leaving the settings at their default values.
You should have noticed a prompt once you entered the workspace about installing the recommended extensions. If you have not done so already, go ahead and approve the install.

If for some reason you did not receive a prompt or have already closed the notification tab, not to worry. Just install these VSCode extensions, leaving the settings at their default values.

--> [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)

--> [vscode-pandoc](https://marketplace.visualstudio.com/items?itemName=DougFinke.vscode-pandoc)

Now, open mdEditor at the base directory using VSCode. Your IDE will auto-discover the `.code-workspace` file and prompt you to reopen the folder as a workspace. Confirm this choice, unless you wish to use a different configuration.

If so, there is a blank `settings.json` in the `.vscode` folder for you. Otherwise, you should disregard said folder completely.

Using this diagram, verify the file structure of your local mdEditor is free from any discrepancies.
Now, using this diagram, verify the file structure of your local mdEditor is free from any discrepancies.

**Tree View**
_mdEditor_
\+---.vscode
\+---.github-templates (+6)
|
+---.vscode
| `settings.json`
| `extensions.json`
|
+---images
| `mdEditor.gif` (+3)
|
+---md
| `project1.md`
| `project2.md`
| `test.txt`
|
+---styles
| `style.css`
| `syntax.md`
|
|`.markdownlint.json`
|`mdEditor.code-workspace`
|`README.md`
|`LICENSE`
|`README.md` (+2)
\---

**NOTE: On Linux you must uncomment the `pandoc.htmlOptString` in the `mdEditor.code-workspace` file. The current version, which uses Windows OS file separators, must be replaced with the Linux version; otherwise, the css styles will not be applied correctly.**
Expand Down

0 comments on commit 5898c7c

Please sign in to comment.