wiki update
This commit is contained in:
parent
56dfce9cb6
commit
be63616469
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
@ -0,0 +1,10 @@
|
|||
# emacs quickstart
|
||||
|
||||
Once you've started emacs, you can type away to your heart's content. To save
|
||||
at any point, press `C-x C-s`. When you want to quit, press `C-c C-x`.
|
||||
|
||||
To move the cursor around you can use the arrow keys; you can also use `C-n`
|
||||
and `C-p` to move the cursor up and down lines.
|
||||
|
||||
For a more thorough introduction, check out [this blog
|
||||
post](http://www.jesshamrick.com/2012/09/10/absolute-beginners-guide-to-emacs/).
|
|
@ -0,0 +1,82 @@
|
|||
# editors
|
||||
|
||||
Inevitably, you're going to want to edit a file on tilde.town. It might be a
|
||||
beautiful pile of HTML, a poem, or some delicious spaghetti code. If you're
|
||||
used to editing files on a graphical desktop it can be kind of daunting to
|
||||
accomplish this task at first.
|
||||
|
||||
This part of the wiki covers the editors we have available on the town, ranked
|
||||
by beginner friendliness.
|
||||
|
||||
|
||||
## protip!
|
||||
|
||||
A lot of documentation on editors (and command line programs in general) tells
|
||||
you about key combinations you can use. While in a graphical desktop you have
|
||||
the ability to either click on `File -> Save` or hit `C-s`, here we just have
|
||||
the latter.
|
||||
|
||||
So when you see `C-s`, that means _hold control and press s, then release_.
|
||||
|
||||
If you see `S-C-s`, that means _hold shift and control, press s, then release_ You probably won't
|
||||
see `S-s` since that just means S.
|
||||
|
||||
The somewhat confusing `M-x` means _hold alt, press x, then release_.
|
||||
|
||||
You might also see `C-c C-x` Which means _hold control and press c, release c, press x, release both keys_.
|
||||
|
||||
**You might also** see the charcter `^` used to mean _hold control_.
|
||||
|
||||
## let's do this
|
||||
|
||||
1. nano
|
||||
|
||||
`nano` can't do much, but what it can do it makes very easy and straightforward.
|
||||
|
||||
nano public_html/index.html
|
||||
|
||||
All of the operations (saving, quitting) are shown whenever you run `nano`,
|
||||
making it self-documented. It's definitely a go-to editor if you're brand new
|
||||
to editing text in a command line environment.
|
||||
|
||||
Our own ~minerobber has [a page](/~minerobber/nanoreference) about `nano`.
|
||||
|
||||
2. micro
|
||||
|
||||
While `micro` is very simple, you do have to do a little more learning than
|
||||
`nano`. You'll be rewarded with more features, though, like split screens and
|
||||
syntax highlighting.
|
||||
|
||||
micro public_html/index.html
|
||||
|
||||
`micro` is intended for beginners and is easy to get going with. Check out our
|
||||
page on [micro](micro.html) for a reference on how to use it.
|
||||
|
||||
3. emacs
|
||||
|
||||
`emacs` has been around for a long time and can do many, many things. It's
|
||||
also easy to extend with your own features, making its list of features
|
||||
essentially infinite. There is a pretty steep learning curve for emacs, but
|
||||
for basic text editing you can get the hang of it pretty quick.
|
||||
|
||||
emacs public_html/index.html
|
||||
|
||||
Check out [our quickstart](emacs.html) to learn more.
|
||||
|
||||
4. vim
|
||||
|
||||
In many ways `vim` is simpler than `emacs`, but it takes an approach to text
|
||||
editing called _modal editing_ that sets it apart from the other editors on
|
||||
this list. This approach is pretty sweet but is not for everyone and takes
|
||||
time to get used to.
|
||||
|
||||
vim public_html/index.html
|
||||
|
||||
Check out [our quickstart](vim.html) to learn more.
|
||||
|
||||
5. everything else
|
||||
|
||||
We have more editors than just the ones listed above, but they are of more
|
||||
interest to those curious about Unix history or obscure software. Check out
|
||||
[~elly's tutorial](https://tilde.town/~elly/ed.html) on `ed` or, from the
|
||||
command line, run `man joe`.
|
|
@ -0,0 +1,9 @@
|
|||
# micro quickstart
|
||||
|
||||
Once `micro` is running, you can edit text to your heart's content.
|
||||
|
||||
Press `C-s` to save at any point and `C-q` to quit.
|
||||
|
||||
To learn more, press `F1` while in `micro`. You can also see all the different
|
||||
keys you can press by pressing `C-e`, typing `help keybindings`, and hitting
|
||||
`enter`.
|
|
@ -0,0 +1,25 @@
|
|||
# vim quickstart
|
||||
|
||||
The core concept of `vim` is _modal editing_, where you are in one of a few
|
||||
modes while editing text. The modes determine what happens when you press
|
||||
keys.
|
||||
|
||||
The most important mode to know is _Insert Mode_, which lets you type things.
|
||||
The default mode is _Normal Mode_, where you can edit the text that is already
|
||||
there or run commands.
|
||||
|
||||
When you start `vim`, press `i`. You should see **-- INSERT --** at the bottom
|
||||
of your screen. You can now type away happily.
|
||||
|
||||
When it's time to save, hit `escape`. The escape key is used in vim to exit
|
||||
whatever mode you are in; thus, from insert mode, you go back to normal mode.
|
||||
|
||||
Now press `:`. In normal mode, this opens a little command line at the bottom
|
||||
of your screen. Type `w` and hit `enter`. You just saved your file.
|
||||
|
||||
To quit, make sure you are in normal mode. press `:`, type `q`, and hit enter.
|
||||
|
||||
For a more in depth tutorial on vim, check out this cool [interactive
|
||||
tutorial](http://www.openvim.com/).
|
||||
|
||||
Our own ~shanx has [a page](/~shanx/vim.html#TIL) about `vim`.
|
|
@ -1,4 +0,0 @@
|
|||
# Text Editor Help
|
||||
- [Vim Reference Chart](http://tilde.town/~shanx/vim.html#reference)
|
||||
- [Vim Daily Tips](http://tilde.town/~shanx/vim.html#TIL)
|
||||
- [nano reference](http://tilde.town/~minerobber/nanoreference)
|
Loading…
Reference in New Issue