wiki update

This commit is contained in:
vilmibm 2017-10-04 00:27:46 +00:00
parent 56dfce9cb6
commit be63616469
9 changed files with 126 additions and 4 deletions

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -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/).

View File

@ -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`.

View File

@ -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`.

View File

@ -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`.

View File

@ -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)