fix(guide): simplify directory structure

This commit is contained in:
Mrugesh Mohapatra
2018-10-16 21:26:13 +05:30
parent f989c28c52
commit da0df12ab7
35752 changed files with 0 additions and 317652 deletions

View File

@ -0,0 +1,34 @@
---
title: Adding Snippets to Your Sublime Text Installation
---
If you are a user of sublime text (I hope you are, it kicks ass. You can get it <a href='https://www.sublimetext.com/' target='_blank' rel='nofollow'>here</a>), then you may have already noticed some of the tab completion capabilities. For example, when you are opening an html tag such as `<p>`, it automatically closes the tag as soon as you type `/`. You can get similar functionality for pieces of code you end up re-writing over and over, and it's surprisingly easy!
Here's an example, which activates after typing `div` and then tab:
![alt text](//discourse-user-assets.s3.amazonaws.com/original/2X/5/59a4d233d2dcb17b76a9c36ca30c5bb07a35d00b.png)
## Step 1.
Click `Tools > New Snippet...` in the navigation bar. This will open a snippet skeletton file which will look like this:
![alt text](//discourse-user-assets.s3.amazonaws.com/original/2X/a/a56106fbf754f7e641342d1ebdbc3f5bed582263.png)
## Step 2.
You will add the snippet by replacing the text `Hello, ${1:this} is a ${2:snippet}.`
In the case of the `div` snippet, it's as simple as placing the following text in the snippet area:
<!-- $1 -->
<div class= "$1">
</div>
<!-- $1 -->
The `$` operator references the variables that will be typed in once you type `div` and then tab. In fact you can have any number of them!
## Step 3.
Save the file. You can give it any filename you want, but the extension **must** be `.sublime-snippet`. Remember, you can only have one snippet per file! I like to give them descriptive names such as `html-div.sublime-snippet`.
And there you have it! You can get as creative as you want.

View File

@ -0,0 +1,75 @@
---
title: Source Code Editors
---
## Source code editors
Source code editors are the programs that allow for code creation and
editing. Any text editor can be used to write code. But dedicated code
editors offer many useful features, including: text completion,
markup coloring, and tabs/panes for side-by-side editing. These features can
be useful even to new users who don't know their way around all of the
advanced options.
### Choosing an editor
There are many, many editors availble to download or use
online, both paid and free. They offer many of the same core-features, but
each have their own subtlties. Further research may help find the one that's
right for you. The following editors are all cross-platform and
free to use or evaluate.
### Sublime text
![Sublime Text Icon](https://logo.clearbit.com/sublimetext.com)
Sublime Text is a very popular editor that has been around <a href='https://www.sublimetext.com/blog/articles/one-point-oh' target='_blank' rel='nofollow'>since 2008</a>. There are many options and <a href='https://packagecontrol.io/' target='_blank' rel='nofollow'>extensions</a> available, and a lot of <a href='http://stackoverflow.com/search?q=sublime+text' target='_blank' rel='nofollow'>help available</a> online to help <a href='http://www.websightdesigns.com/wiki/Setting_up_Sublime_Text_3' target='_blank' rel='nofollow'>set it up</a>. (The license for continued use costs $70\. However, Sublime Text is free to download and evaluate, with a nag-screen pop-up.)
<a href='https://www.sublimetext.com/' target='_blank' rel='nofollow'>sublimetext.com</a>
![Sublime Text Screenshot](//discourse-user-assets.s3.amazonaws.com/original/2X/6/63f774c31a7b1a439bcef9d11e95463b6998310e.png)
&nbsp;
### Brackets
![Brackets Icon](https://logo.clearbit.com/brackets.io)
Brackets is a relatively new open-source editor by Adobe. It is very user friendly, especially for people who aren't used to command-line interfaces or JSON-style settings/prefereces. Extensions and themes are quick and easy to find and install through the Extension Manager.
<a href='http://brackets.io/' target='_blank' rel='nofollow'>brackets.io</a>
![Brackets Screenshot](//discourse-user-assets.s3.amazonaws.com/original/2X/2/2f395a58d24ed551ed8440a10ae640777f1143b6.png)
&nbsp;
### Atom
![Atom Icon](https://logo.clearbit.com/atom.io)
Atom is an <a href='https://github.com/atom/atom' target='_blank' rel='nofollow'>open source</a> editor, developed by <a href='https://github.com/' target='_blank' rel='nofollow'>GitHub</a>. Like Sublime Text, Atom is quite popular. It is very configurable ("hackable", as they say) but advanced features may be overwhelming to new users. There is also plenty of <a href='http://readwrite.com/2014/05/20/github-atom-5-tips-getting-started-tutorial-corey-johnson/' target='_blank' rel='nofollow'>helpful</a> <a href='http://flight-manual.atom.io/' target='_blank' rel='nofollow'>documentation</a> <a href='http://stackoverflow.com/search?q=atom' target='_blank' rel='nofollow'>availble</a> online.
<a href='https://atom.io/' target='_blank' rel='nofollow'>atom.io</a>
![Atom Screenshot](//discourse-user-assets.s3.amazonaws.com/original/2X/8/8016e7c0937e8ce6fcb6104c9aee0026443912f5.png)
&nbsp;
### Visual Studio Code
![Visual Studio Code Icon](https://logo.clearbit.com/code.visualstudio.com)
Visual Studio Code (a.k.a vsc or vscode) is a very popular, open source editor, developed by <a href="https://www.microsoft.com" target="_blank" rel="nofollow">Microsoft</a> and fast becoming widely used by developers of all languages. Like Atom and Sublime, Visual Studio Code has a wide range of <a href="https://marketplace.visualstudio.com/VSCode" target="_blank" rel="nofollow">extensions</a> and <a href="https://marketplace.visualstudio.com/search?target=VSCode&category=Themes&sortBy=Downloads" target="_blank" rel="nofollow">themes</a> available to help customise and perfect your experience using it, however VSC is highly configurable "out-the-box". There is also a very active development team behind VSCode, with new features and bug fixes being added by the Visual Studio Code team <a href="https://code.visualstudio.com/updates" target="_blank" rel="nofollow">every month</a>.
<a href='https://code.visualstudio.com/' target='_blank' rel='nofollow'>code.visualstudio.com</a>
&bnsp;
### Notepad++
![Notepad++ Icon](https://upload.wikimedia.org/wikipedia/commons/0/0f/Notepad%2B%2B_Logo.png)
Notepad++ is a free, open source code editor, that runs in the Microsoft Windows Environment. It was developed in 2003, by Dan Ho. It is written in <a href='www.cplusplus.com' target='_blank' rel='nofollow'>C++</a> (the name comes from that). Notepad++ supports tabbed editing, wich allows working with multiple open files in a single window, and also can be use as a plain text editor.
<a href='https://notepad-plus-plus.org' target='_blank' rel='nofollow'>notepad-plus-plus.org</a>