mirror of
https://github.com/tildeclub/site.git
synced 2026-01-24 05:50:17 +00:00
import more wiki articles, and exclude unmodified users from listing
This commit is contained in:
20
wiki/source/Editing-your-index.html-file.md
Normal file
20
wiki/source/Editing-your-index.html-file.md
Normal file
@@ -0,0 +1,20 @@
|
||||
---
|
||||
title: Editing your index.html file
|
||||
---
|
||||
|
||||
Type: `nano` index.html to open your index.html file and begin editing
|
||||
|
||||

|
||||
|
||||
Edit your file, willy nilly
|
||||
|
||||
When done editing, use `CTRL+X` to close the file
|
||||
|
||||
You'll be asked if you want to save; say y and [return] to return to the command line
|
||||
|
||||
Refresh your tilde page in your browser to see your new website
|
||||
|
||||
Note: If at any time you feel you made a mistake in editing, you can exit and n to not save.
|
||||
|
||||
There's more info here about the [[nano]] editor; if you're familiar with
|
||||
[[emacs]] or [[vim]] they are here too.
|
||||
17
wiki/source/Finding-your-index.html-file.md
Normal file
17
wiki/source/Finding-your-index.html-file.md
Normal file
@@ -0,0 +1,17 @@
|
||||
---
|
||||
title: Finding your index.html file
|
||||
---
|
||||
|
||||
There are some basic command line commands you'll want to Google and learn, but for this tutorial you only need a few:
|
||||
|
||||
`ls` = list files and folders in current directory
|
||||
|
||||
`cd` = change directories
|
||||
|
||||
`vim`, `emacs`, `nano` = a text editor
|
||||
|
||||
Type: `ls` to see where you are; you should see a directory called "public_html"
|
||||
|
||||
Type: `cd public_html` to browse into that folder
|
||||
|
||||
Type: `ls` to see where you are; you should see your index.html file
|
||||
20
wiki/source/JSON.md
Normal file
20
wiki/source/JSON.md
Normal file
@@ -0,0 +1,20 @@
|
||||
---
|
||||
title: JSON
|
||||
---
|
||||
|
||||
JSON is the "Javascript Object Notation", basically a file format for
|
||||
data that's suitable for easy processing by most modern web-based tools.
|
||||
|
||||
Several tilde.club programs expose APIs essentially by spitting out
|
||||
JSON as their output, including e.g. the list of recently updated home
|
||||
pages at
|
||||
|
||||
http://tilde.club/~delfuego/tilde.24h.json
|
||||
|
||||
If you're looking to parse JSON from the command line with a minimum of
|
||||
code, the `jq` program may be your thing. `jq` is a filter that takes
|
||||
JSON on standard input and produces JSON on standard output. Along the
|
||||
way in the middle you can do various standard sorts of file munging on
|
||||
a field by field basis.
|
||||
|
||||
[Documentation for `jq` is in its manual.](http://stedolan.github.io/jq/manual/)
|
||||
@@ -0,0 +1,12 @@
|
||||
---
|
||||
title: Resetting your editor view when chat interrupts
|
||||
---
|
||||
|
||||
You may have been caught off guard while editing and had some random chat messages muss up your view. It didn't actually edit your HTML page but you need to reset your editor view.
|
||||
|
||||
`CTRL+L` will reset your view
|
||||
|
||||
`mesg n` at the command prompt will turn off chat messages in that window.
|
||||
|
||||
If you don't ever want to see wall messages on your screen, put `mesg n`
|
||||
into your startup file (details of how to do that needed here).
|
||||
12
wiki/source/VPN-Gate.md
Normal file
12
wiki/source/VPN-Gate.md
Normal file
@@ -0,0 +1,12 @@
|
||||
---
|
||||
title: VPN Gate
|
||||
---
|
||||
|
||||
`VPN Gate` is a project from U Tsukuba in Japan that allows you to
|
||||
evade censorship and filtering by setting up VPN tunnels. It was
|
||||
designed with the Great Firewall of China in mind.
|
||||
|
||||
http://www.vpngate.net/en/
|
||||
|
||||
You may need client side software to make this work; [[tunnelblick]] is one
|
||||
such service on the Mac.
|
||||
5
wiki/source/archive.org.md
Normal file
5
wiki/source/archive.org.md
Normal file
@@ -0,0 +1,5 @@
|
||||
---
|
||||
title: archive.org
|
||||
---
|
||||
|
||||
archive.org has an archive of tilde.club at http://web.archive.org/web/*/http://tilde.club
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
title: Socializing
|
||||
title: Socializing and chat
|
||||
author:
|
||||
- emv
|
||||
- benharri
|
||||
|
||||
56
wiki/source/git.md
Normal file
56
wiki/source/git.md
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: git usage
|
||||
---
|
||||
|
||||
`git` is a version control system. It's pretty confusing at first, but once you sort out what it can do and can't do, it starts to get better.
|
||||
|
||||
This tutorial is pretty good: http://git-scm.com/docs/gittutorial
|
||||
|
||||
The best way to learn `git` is to find someone who knows `git` really well and sort out issues with them. Ask on [[IRC]] if you get stuck. (There should be a better buddy system for this, but until there is, we do what we can.)
|
||||
|
||||
A good introduction to `git` is to create a repository for your `public_html` directory. This will allow you to back up your public web directory.
|
||||
|
||||
First thing you will want to do is set up git.
|
||||
|
||||
If you don't have a [GitHub](http://github.com) account, you will want one for this exercise. If you choose another Git host, you will need to work out some parts of this setup on your own.
|
||||
|
||||
Once you have a git account, you will want to set up `git` for your tilde.club account. Use the email address that you used to create your GitHub account. You can register multiple accounts with GitHub if needed.
|
||||
|
||||
git config --global user.name "Your Name Here"
|
||||
git config --global user.email youremail@example.org
|
||||
|
||||
You will also want to create a `.gitignore` file. This file defines what things you want git to ignore, such as editor temporary files or directories you may not want to keep in `git` such as generated files or private files you upload to a public repository. The `.gitignore` file can be created in your home directory, but I like to create it in the project directory.
|
||||
|
||||
Here is an example `.gitignore` file:
|
||||
|
||||
# files being edited
|
||||
*~
|
||||
*swp
|
||||
# Generated files
|
||||
tilde_graphs
|
||||
# Private files
|
||||
diary.txt
|
||||
|
||||
Now go create a repository on GitHub. In our examples we are using mytildeweb as the repo name, but you can choose whatever name works for you. If you do change the repository name be sure to update the commands with the proper one.
|
||||
|
||||
Now we should be ready to create and upload the repository.
|
||||
|
||||
cd public_html/
|
||||
# This will initialize public_html as a repository
|
||||
git init
|
||||
# Adds all files to the repo. "." means "the current directory" (public_html, in this case)
|
||||
# Note: you can also add files one at a time
|
||||
git add .
|
||||
# Commits files to local repo
|
||||
git commit -m "first commit of tildeweb"
|
||||
# Tells git where your remote repo is
|
||||
git remote add origin https://github.com/<yourgithubuser>/mytildeweb.git
|
||||
# Uploads to the remote repo
|
||||
git push -u origin master
|
||||
|
||||
Your files should now be on GitHub. If you make a change and you want to update, do the following after making your edits:
|
||||
|
||||
git add index.html
|
||||
git commit -m "updated blog"
|
||||
git push origin master
|
||||
|
||||
7
wiki/source/leafnode.md
Normal file
7
wiki/source/leafnode.md
Normal file
@@ -0,0 +1,7 @@
|
||||
---
|
||||
title: Leafnode
|
||||
---
|
||||
|
||||
`leafnode` is a news client suitable for "leaf" nodes, that is nodes that have no downstream feeds.
|
||||
|
||||
http://leafnode.sourceforge.net/
|
||||
7
wiki/source/sshfs.md
Normal file
7
wiki/source/sshfs.md
Normal file
@@ -0,0 +1,7 @@
|
||||
---
|
||||
title: SSHFS
|
||||
---
|
||||
|
||||
With `sshfs` you can mount your tilde directory as a drive.
|
||||
|
||||
See http://tilde.club/~jeffbonhag/sshfs.txt for a tutorial.
|
||||
41
wiki/source/tmux.md
Normal file
41
wiki/source/tmux.md
Normal file
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: tmux
|
||||
---
|
||||
|
||||
TMUX IS THE BEST. Here's a super basic primer.
|
||||
|
||||
to start a new session, type `tmux new -s tildemux`.
|
||||
|
||||
A yellow bar will appear at the bottom of your terminal. You're now in TMUX!
|
||||
|
||||
TMUX has sessions, windows, and panes. Each of these things will have a terminal in it. If you actually typed what I told you to earlier, you'll be in a session named `tildemux`. That session has one window, `0`. That window has one pane, also named `0`. (Computers start counting at 0, not 1.)
|
||||
|
||||
## windows
|
||||
|
||||
Your tmux bar should look like:
|
||||
|
||||
`[tildemux] 0:bash*`
|
||||
|
||||
…which means that you're in a session named `tildemux`, which has a window `0`, running the command `bash`. `*` means that window 0 is active, and the pane running bash is currently active.
|
||||
|
||||
To create a new window within this session, type `PREFIX c`. PREFIX?!? By default, it's `control-b`. Now you should see:
|
||||
|
||||
`[tildemux] 0:bash- 1:bash*`
|
||||
|
||||
`1:bash*` means you're in a pane running `bash` inside window 1. To change back to pane 0, type `PREFIX 0`. The `*` should be back on `0:bash`.
|
||||
|
||||
Run a cool interactive command, such as `htop` (to see how many of system resources we're eating up) or `vim` (to write some awesome webpages). Your tmux status bar should update to `0:<name of the current process>`. So now instead of saying `bash` it will say `htop` or `vim`.
|
||||
|
||||
## panes
|
||||
|
||||
Panes are great. TMUX panes let you run more than one terminal inside your one, actual terminal. To "split" a new pane, `PREFIX "`. That makes a horizontal split. You'll notice there are now two panes open one on top of the other. `PREFIX %` makes a vertical split, for side-by-side panes. Did I mention that panes are great?
|
||||
|
||||
To move between panes in the current window, use `PREFIX <up,down,left,right>`. That's right, the arrow keys.
|
||||
|
||||
## more
|
||||
|
||||
I not the best writer or teacher. Just google anything that doesn't make sense.
|
||||
|
||||
[Or take a look at this tmux guide](http://robots.thoughtbot.com/a-tmux-crash-course)
|
||||
|
||||
But definitely use tmux.
|
||||
13
wiki/source/tunnelblick.md
Normal file
13
wiki/source/tunnelblick.md
Normal file
@@ -0,0 +1,13 @@
|
||||
---
|
||||
title: Tunnelblick
|
||||
---
|
||||
|
||||
`tunnelblick` is an application for your Mac that allows you to configure
|
||||
and manage VPN sessions. You can use this e.g. if you are connecting to
|
||||
tilde.club via a network that does not allow high UDP ports; with a properly
|
||||
configured tunnel, you can still run [[mosh]] as your shell and keep on
|
||||
truckin.
|
||||
|
||||
https://code.google.com/p/tunnelblick/
|
||||
|
||||
To find a VPN endpoint, see the [[VPN Gate]] project.
|
||||
18
wiki/source/vimrc.md
Normal file
18
wiki/source/vimrc.md
Normal file
@@ -0,0 +1,18 @@
|
||||
---
|
||||
title: .vimrc file
|
||||
---
|
||||
|
||||
The file `.vimrc` in your home directory has instructions for [[vim]]
|
||||
to load every time it runs. Customizations go there.
|
||||
|
||||
For instance, you might want to use [[Markdown]] to edit files that
|
||||
end in `.md`. The system default for some reason is to treat these as
|
||||
[[Modula-2]] files, though we don't have a Modula-2 compiler running
|
||||
(yet). So the contents of `.vimrc` should read
|
||||
|
||||
``
|
||||
au BufRead,BufNewFile *.md set filetype=markdown
|
||||
``
|
||||
|
||||
For more suggestions in deep depth on how to set up your `.vimrc` please read
|
||||
[this tutorial from Doug Black](http://dougblack.io/words/a-good-vimrc.html).
|
||||
Reference in New Issue
Block a user