Flashcards Deluxe
Working Without This Website


Introduction - Working without this website

In order to download flashcards to your iPhone, your flashcard text needs to be in a text file available over http. Using a "deck code" and this website (OrangeOrApple.com), these details are hidden from you. If you don't want to use this web site, you can put a text file with your card data on any web server and download it from within this iPhone application. When adding a new private deck from your iPhone, instead of entering a deck code, you can enter a full http path of a text file to download (in the deck code field).

Required Format

Generally you'll use Notepad (PC) or TextEdit (Mac / plain text format) to hold your flashcard text. The text should have have 2 to 6 items per line and be tab delimited, meaning that each items on a line is separated by a tab. (The fields are: Side 1 text, side 2 text, side 3 text, category 1, category 2, statistics.) In it's simpliest form, you'll have   question {tab} answer {return} . If using Excel, you can just copy-paste into notepad/TextEdit. The file needs to be in plain text UTF-8 format, so make sure you choose this encoding when saving your text file. Do not use spaces in the file name.

If you have picture or sound files, you need to put them in a location where the app can find them when downloading. You have a few options:

1) Create a directory with the same name as your text file (without the extension) and put the files in there. Sample text data and directory structure:
        Side 1 text     {tab}     <pic Side2.jpg>

        Sample.txt
        Sample\
                    Side2.jpg

2) Use the "media-dir" header to specify where the media files are located. Example header line (which just needs to exist in the text file before any card data):
        *     {tab}     media-dir     {tab}     http://dl.dropbox.com/u/1234567/Sample/

3) Specify full URL paths for your media files, for example:
        <pic http://dl.dropbox.com/u/1234567/Sample/Side2.jpg>

I'd recommend keeping your picture files small (less than 600x600 pixels) to save space on your iPhone and keep downloads quick.


Dropbox

Dropbox is a popular web storage utility that you can use to house your flashcard data. A free account will get you about 2GB of storage. You can either use their website or their .exe to upload files. Create your text (.txt) file as shown above, and put the txt file in the "Public" folder. (This app doesn't support login information.) If including pictures/sounds, follow above instructions for different options. Now you need to know the URL of your text file... in Dropbox, right-click on your text file (in the Public folder) and choose "Copy public link". (If you have a single button mouse with your Mac, control-click to bring up this shortcut menu.) Within the app, add a new private deck, and in the deck code field type in the URL of the txt file, such as "dl.dropbox.com/u/12345678/MyDeck.txt" (http:// optional).



Setting up web sharing on Mac OS X

Mac OS X comes with a web server ready to run and easy to set up, so I'll walk through this scenario. I'm not going to discuss doing this in Microsoft Windows, but the concept is similar.

Go to system preferences (in the Apple Menu)
Click "Sharing" (in the Internet & Network section)
Enable "Web Sharing"
You should see your personal website address (e.g. http://192.168.1.102/~ernie/)

* Saving your card text

Put your card text into a text file. The program TextEdit works well for this purpose. Remember that each line needs to have to two items of text, separated by a tab.

Now you need to know how to save the file and where to save the file. As for how, save as plain text in UTF-8 encoding. The Format menu has an option to switch between "Make Plain Text" and "Make Rich Text". When choosing save, make sure "Unicode (UTF-8)" is the selected encoding. As for where, save the file in the "Users/[your user name]/Sites/" directory.

* Downloading from your iPhone

Within the program, tap "Add" then tap the "Deck Code / Source File" field. Here you will enter the web address of your text file. If I created a text file named "sample.txt", I would enter "192.168.1.102/~ernie/sample.txt". Click download cards, and you are done!

Misc notes: Your file name must not contain any spaces. To enter a ~ in the iPhone, tap the "@123" button, then tap shift (up arrow) to view more input options. Instead of using an address like 192.168.1.102, look at the top of the "Sharing" preference screen about using a name like "ernies-mac.local".