added initial README file

this file contains instructions for using this repo.

diff --git a/README.mdwn b/README.mdwn
new file mode 100644 (file)
index 0000000..f6f6bcb
--- /dev/null
+++ b/README.mdwn
@@ -0,0 +1,63 @@
+# README
+
+## Getting the base ISO
+
+This script assumes that you are starting with the special ISO from the
+following URL. It already contains video files that the script in this repo
+will not try to download.
+
+<http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0-fsf_i686.iso>
+
+The corresponding source code ISO can be found here:
+
+<http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0fsf_sources.iso>
+
+Feel free to test your download with the `trisquel_9.0-fsf_i686.iso.sha256`
+file in this repo:
+
+    sha2565sum -c trisquel_9.0-fsf_i686.iso.sha256
+    sha2565sum -c trisquel_9.0fsf_sources.iso.sha256
+
+## Making a bootable USB drive
+
+This should work on an external USB drive, ideally one that is 12 GB or greater
+in size. Note that using a loop device will probably not work, partly due to
+the way syslinux behaves with loop devices. If you get that working, feel free
+to submit a patch to <sysadmin@gnu.org>. : )
+
+You'll need to download and install old versions of syslinux:
+
+* <https://mirror.fsf.org/trisquel/pool/main/s/syslinux/syslinux-common_4.05+dfsg-6+deb8u1_all.deb>
+* <https://mirror.fsf.org/trisquel/pool/main/s/syslinux/syslinux_4.05+dfsg-6+deb8u1_amd64.deb>
+
+Check files, install them, and run the script:
+
+    sha256sum -c syslinux.deb.sha256
+
+    dpkg -i syslinux-common_4.05+dfsg-6+deb8u1_all.deb
+    dpkg -i syslinux_4.05+dfsg-6+deb8u1_amd64.deb
+
+    sudo ./live-usb-loader.sh trisquel_9.0-fsf_i686.iso /dev/sdb
+
+## Installing extra media, including Trisquel 9 source code
+
+    sudo ./install-extras.sh trisquel_9.0fsf_sources.iso /dev/sdb
+
+## Notes about video files and free space
+
+You may wish to transcode the downloaded videos to save space on the member
+card, in particular `lp2020_kahle.webm` and `lp2020_younghackers.webm`.
+
+    ffmpeg -i foo.webm -acodec libvorbis -b:a 64k -vcodec libvpx -vf scale=-1:720 -b:v 800k -preset medium foo_smaller.webm
+
+    # check to make sure that the video quality is okay
+    mplayer foo_smaller.webm
+
+    mv foo_smaller.webm foo.webm
+
+Then optionally update the checksum file for `/mnt/fsf/GNUAV/`:
+
+    cd /mnt/fsf/GNUAV/
+    sha256sum ./ > ../checksums.sha256
+    mv ../checksums.sha256 .
+