here are the home pages of our users
+if you're not seeing yourself listed here, change your page from the default.
- ~ diff --git a/wiki/Editing-your-index.html-file.html b/wiki/Editing-your-index.html-file.html new file mode 100644 index 0000000..1b5741d --- /dev/null +++ b/wiki/Editing-your-index.html-file.html @@ -0,0 +1,38 @@ + + + + + + +
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.
+ + + diff --git a/wiki/Finding-your-index.html-file.html b/wiki/Finding-your-index.html-file.html new file mode 100644 index 0000000..8e20843 --- /dev/null +++ b/wiki/Finding-your-index.html-file.html @@ -0,0 +1,35 @@ + + + + + + +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
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.
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).
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.
+ + + diff --git a/wiki/archive.org.html b/wiki/archive.org.html new file mode 100644 index 0000000..af13eda --- /dev/null +++ b/wiki/archive.org.html @@ -0,0 +1,29 @@ + + + + + + +archive.org
+ + +archive.org has an archive of tilde.club at http://web.archive.org/web/*/http://tilde.club
+ + + diff --git a/wiki/chat.html b/wiki/chat.html index 639829f..f8e358c 100644 --- a/wiki/chat.html +++ b/wiki/chat.html @@ -6,7 +6,7 @@ -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 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.orgYou 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.txtNow 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 masterYour 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