Initial commit. In a broken state, do not use.

content/site/getting-started/01-01-release-download.md

@@ -0,0 +1,27 @@
+# Latest Release
+
+## Download
+
+This release is still Alpha code, which means that it is under development and it has important problems and limitations.
+
+We have a single installation file for all available languages, but not all translations are equally complete. Much work remains to be done and any help is most welcome.
+
+You can find the compressed image file here:
+<https://public.f123.org/latestImage>
+
+ We are also including the [sha1sum signature for the image](latestImage.sha1sum) file, so you can verify file integrity after download. Please note that the image is compressed with the xz format, which is more efficient than the zip format. You may find [information on how to uncompress xz files here](http://www.e7z.org/open-xz-txz.htm).
+
+### The First Time You Turn-On the Computer
+
+During the first time you start or boot the computer, the software will auto-expand the partition and file system to match the size of the Micro-SD card, so it can take a minute and a half or more for the Raspberry Pi 3B+ computer to be ready. Subsequent boots will be faster, i.e. around 30 seconds.
+
+### Default Username and Passwords
+
+the default username is: f123
+
+The default user and admin password is lowercase: f123
+
+The hostname is (lowercase): f123light
+
+Advanced users can easily build images with WiFi and other passwords already set to personalized values. [Information on custom images can be found here](advanced.html#build-a-custom-image).
+

content/site/getting-started/01-02-release-burn.md

@@ -0,0 +1,8 @@
+## Burning/Flashing the F123Light Image File to the Micro-SD Card
+
+Once you download and verify the integrity of the compressed version of the image file, you must uncompress this file and flash or burn it to the micro-SD card which you will use on the Raspberry Pi computer. We recommend that you use a micro-SD card of at least 16Gb in size, but an 8Gb card should also work, even though little disk space will be available for your own files.
+
+The expressions "flash" or "burn the image" is used because this is not the same as a copy and paste file transfer. While there are many ways to "flash" the image to the card, we have heard good things about both [Etcher](https://etcher.io/) and [Rufus](https://rufus.ie/) software. Etcher apparently works well in Windows, Mac, and Linux, whereas Rufus works well on Windows.
+
+It is also worth mentioning that burning an image will not prevent you from reformatting or burning other images on the SD card in the future. In other words, even though people use the word "burn", the process is not permanent. It is just another method for temporarily saving a file.
+

content/site/getting-started/01-03-release-update.md

@@ -0,0 +1,8 @@
+## Updating the F123Light Operating System
+
+In the "Main Menu" there is a sub-menu called "Settings", which has an option that makes it easy to update the system, called: "Check for system updates"
+
+Thanks to this option, it is usually not necessary to flash a new image or use complicated commands whenever a new version of F123Light is available. However, we do recommend that you stay in touch with our team, as at this stage in the project, new versions are sometimes experimental, and are not recommended for all users.
+
+If you are a technically-oriented or advanced computer user, you might want to explore the more advanced options described in [our technical guide](advanced.html).
+

content/site/getting-started/01-04-release-build.md

@@ -0,0 +1,12 @@
+# Developers and Other Advanced Users
+
+## Updating F123Light on the Command Line
+
+Advanced users can perform an update from the command line with the command: "update-f123light"
+
+If such a user is helping us test recent changes to the code, he or she can use a special parameter to update from the development branch. To specify the development branch, the correct command would be: "update-f123light -b dev
+
+## Building Your Own F123Light Image
+
+Experienced users also have the option of generating or building their own image. Every copy of F123Light includes the command "build-f123light", which automatically generates the image file, which can then be burned or flashed to a MicroSD card for use. Please make sure your working SD card has at least 8Gb of free space to perform this procedure. You may lern more about building your own image in our [resources for advanced users page](advanced.html).
+

content/site/getting-started/01-09-acknowledgement.md

@@ -0,0 +1,4 @@
+## Acknowledgements
+
+Our work is only possible thanks to a [wide variety of persons and organizations](https://f123.org/en/acknowledgements), from volunteers and our own users, to developers, translators, journalists, teachers, funders, and many more. Thank you all!
+

content/site/getting-started/02-00-configuration.md

@@ -0,0 +1,4 @@
+## Initial Operating System Configuration
+
+The very first time you start-up your computer with the MicroSD card containing F123Light, the start-up or boot process will take longer than usual, as the system is uncompressing and preparing the file system for use. The larger the capacity in your MicroSD card (i.e. the more memory it has), the longer this process will take. In any case, it will generally be two or three minutes at the most.
+

content/site/getting-started/02-01-fenrir-basics.md

@@ -0,0 +1,28 @@
+### Basic Commands for the Fenrir Screen Reader
+
+Most users will be very happy to know that for maybe the first time in history, using a new screen reader will not necessarily require you to learn new keyboard commands. This is because, if you already use the NVDA screen reader, you will probably feel right at home with the key combinations used by Fenrir, the main screen reader of F123Light.
+
+#### Controls for Speech Volume, Rate, and Pitch
+
+Just like in NVDA, you can use Insert, Control, and the arrow keys to modify speech parameters like volume, rate, and pitch. Insert, also called the Fenrir key or the NVDA key, depending on which manual you are reading, can also be the CapsLock key, if you are using the screen reader in laptop mode.
+
+To change speech volume, rate, or pitch, hold down the Fenrir key and the Control key, and use the left and right arrow keys to select if you want to change volume, rate, or pitch. Once you are on the parameter you wish to change, use the up and down arrow keys to increase or decrease that parameter.
+
+Once the speech volume, rate, or pitch is at the level you desire, simply release the Fenrir and the Control keys, and continue using your computer normally.
+
+#### Using Tutorial, Help, or Learn Mode
+
+Pressing the Fenrir and F1 keys, your screen reader will activate its "Tutorial Mode", which allows you to press just about any key, and hear its name and function, if it has a special screen reader function. When you are in "Tutorial Mode", you can press keys and, other than telling you what they normally do, the system will not do anything else. It is an excellent way to learn your way around Fenrir and your keyboard.
+
+To deactivate "Tutorial Mode", simply press Fenrir and F1 again, or press the 'Escape' key, also often labeled as 'ESC'. The 'Escape' key is found usually at the top left of most keyboards.
+
+#### Reviewing the Screen
+
+Just like with most screen readers, Fenrir uses the numeric keypad on the full desktop keyboard for many of its commands. This is especially true for those which involve movement, such as reading previous or next line, word, or character.
+
+Assuming that you are using a full-size desktop keyboard, which has a numeric keypad to its right, you can use: numbers 7, 8, and 9, to read previous, current, and next line; numbers 4, 5, and 6, to read previous, current, and next word; and numbers 1, 2, and 3, to read previous, current, and next character.
+
+If you are using Fenrir in laptop mode, in other words, assuming you do not have a numeric keypad on your keyboard, then you must hold down the CapsLock key, which becomes the new Fenrir key, and press letters U, I, and O, for previous, current, and next line; letters J, K, and L, for previous, current, and next word; and N, M, and the comma symbol, for previous, current, and next character.
+
+Of course, if you used our fast language switching command to change language, the keyboard layout as well as the instant spell checker, will also change. However, the location remains the same. You will still use your right hand in its standard positioning on the keyboard, to read around the screen when holding down the CapsLock key.
+

content/site/getting-started/02-02-language-selection.md

@@ -0,0 +1,8 @@
+### Selecting the Operating System Language
+
+The very first version of F123Light is available in English, but shortly will also be available in Brazilian Portuguese, Spanish, and Arabic. Please [join the e-mail list corresponding to the language you are interested in](guide.html#our-e-mail-lists), and you will be notified when it becomes available.
+
+The very first time F123Light loads, it gives you a chance to select the language you will use the system in. Press 'Enter' for English, or use the up and down arrow keys to select another option and press 'Enter'. Once you do this, the system will make a sound and restart in the language you selected.
+
+If you selected a language which is still not officially supported, the interface might still not be entirely translated.
+

content/site/getting-started/02-03-system-passwords.md

@@ -0,0 +1,18 @@
+### Change System Passwords
+
+Another question that comes-up when you boot your computer for the first time, relates to changing system passwords. If you are just testing the system and have no plans to use it for more than a few minutes, then there is no nee for you to change system passwords. However, if you will use the system for more than just a few minutes, we recommend that you change the default passwords.
+
+If you press "Enter" for "Yes", you will have a chance to change both the password for the normal user, and the administrator's password. Here is some information which might come-in handy:
+
+The name of the default user in F123Light is: f123
+
+Please note that this name is with a lowercase "f".
+
+The default password for the normal user is exactly the same: f123
+
+The default name of the root or administrator, is: root
+
+Here also, the name is entirely in lowercase.
+
+The default password for the administrator or root user is exactly the same, also in lowercase: root
+

content/site/getting-started/02-04-configuring-wifi.md

@@ -0,0 +1,9 @@
+### Configuring WiFi
+
+The quickest way to get internet access is usually to just plug-in an Ethernet cable connected to a router providing that access. However, most often people end-up using wireless access through WiFi.
+
+The configuration process which helps you setup your system when you turn it on for the first time, will also help you configure WiFi, since this access will be required when it is time to select the region where you live.
+
+Setting-up WiFi is easy, just use the up and down arrow keys to select the name of your WiFi network from the provided list and press 'Enter'.
+
+Next, enter the password for that WiFi network or access point 

content/site/getting-started/02-05-region-selection.md

@@ -0,0 +1,8 @@
+### Selecting Your Region
+
+The F123Light operating system sometimes needs to know where in the world you are located. This is helpful so it can find out what day and time it is, and it can then figure-out if, for example, a new update to the software is actually new.
+
+First you must use the up and down arrow keys to select the region where you are and then press 'Enter'.
+
+Then you need to select the city where you live from a list and again press 'Enter'. Since the list only contains the largest cities, your own city might not be on the list. If this happens, please select another city which is near-by, or at least in the same timezone.
+

content/site/getting-started/03-00-basics-introduction.md

@@ -0,0 +1,4 @@
+# Introduction to the Basics
+
+In this section we will describe the commands and shortcuts you can use for routine operations with F123Light. Since the system is undergoing rapid development, there may be times in which the documentation does not perfectly match the latest version of the software. If you encounter difficulties, please [let us know through one of our e-mail lists](guide.html#our-e-mail-lists).
+

content/site/getting-started/03-02-bluetooth.md

@@ -0,0 +1,40 @@
+# Bluetooth in F123Light
+
+Connecting bluetooth devices such as headsets and keyboards is fairly straightforward in F123Light.
+
+## Common Steps to Get Started
+
+* Start by navigating to the Settings menu by pressing s.
+* Press b to open the bluetooth manager.
+* You will hear "screen reader on" followed by "Bluetooth devices frame." Note: this may take up to 15 seconds.
+* Put your device into  pairing or discovery mode. Each device can be different, so it helps to know how to do this on the specific device. For example, some devices allow you to hold in the power button, while others have dedicated pairing buttons.
+* The "Search button" in the bluetooth device manager is already focused. Press the space bar to activate it.
+* Press the tab key twice. You will hear some table information that you can ignore.
+* Use the up and down arrow keys to navigate to the device you want to pair.
+
+## Pairing Headsets and Speakers
+
+* Press the tab key to leave the list of devices and focus the search button.
+* Press the right arrow key twice. The first time you will hear "trust push button." The next time you will hear "Setup ... push button."
+* Press the space bar to activate setup.
+* The pairing method is already set, so you can press shift+tab to the "Next push button."
+* "Audio sink"  is selected by default, so again press shift+tab to the "Next push button."
+* Your headset or speakers should now be connected. Press the space bar to close the setup application.
+* Press the left arrow once to "Trust push button" and press the space bar.
+* If you want to pair another device, put the new device into pairing mode, press the left arrow again to the "Search push button" and then tab
+ to go back to the list and find the new device. Repeat either the pairing steps for headsets or speakers, or if your device is a keyboard, continue to the next heading.
+
+## Pairing a keyboard
+
+* Press the tab key to leave the list and press the right arrow to the "Pair push button."
+* Press the space bar on your USB keyboard to begin the pairing process.
+* You will hear "pairing request for" followed by a string of letters and numbers, followed by a short pause and a 6-digit pairing code, all numbers. On the bluetooth keyboard, type in the 6-digit code followed by the enter key.
+* Be sure to listen for all 6 digits of the code; it is spoken as a whole number. However, speech is interrupted as you type on the bluetooth keyboard, so you can listen for the code again if you get stuck in the middle.
+* You should hear "Authorization request for" followed by the letters and numbers you heard when pairing. Press the tab key on the USB keyboard to accept the request.
+* Once you accept the authorization request, you should hear an upward sweeping tone. This indicates that your keyboard is connected.
+* Press the escape key until you hear "Bluetooth Devices frame" again. Press the left arrow to the "Trust push button" and press the space bar.
+
+## All Devices Are Paired and Connected
+
+* Press alt+F4 to return to the settings menu and the escape key to return to the F123Light main menu.
+

content/site/getting-started/03-02-editor.md

@@ -0,0 +1,34 @@
+## An Introduction to the Text Editor
+
+The default text editor in the F123Light system is called Nice Editor (NE). This editor is small in size, fast, easy to use, and feature rich.
+
+The keyboard shortcuts or key bindings used in the F123Light version of Nice Editor are modified so that anybody who has used an editor under Windows or other graphical user interfaces (GUIS), will have a very easy time using it.
+
+You will also notice that for some functions, more than one shortcut is available. This is because depending on what editor you use the most, you might for example, close a document with Ctrl+W or maybe with Ctrl+Q. Since both combinations work on F123Light's version of Nano, you will probably be able to just keep using what you are used-to.
+
+Here is a list of shortcuts. Remember, you can also use Fenrir's virtual menu system (Insert+F10), if you get stuck or can't remember something: 
+
+* Control+O: Open a new file. This does not close any previous files you have open.
+* Control+S: Save current file.
+* Control+w: Save the current file and exit if there are no other open files.
+* Control+q: Save the current file and exit if there are no other open files.
+* F4: Save the current file and exit if there are no other open files.
+* F7: Activates the spellchecker.
+* Hold down the Shift key and move with the arrow keys to highlight portions of the text and use Ctrl+X, Ctrl+C, and Ctrl+V to cut, copy, and paste.
+* Press Home or End to move directly to the beginning or end of the current line.
+* Press Control and left or right arrow to move one word at a time.
+* Press Ctrl+Home or Ctrl+End to move directly to the beginning or end of the current file.
+* Control+x: Cut the current line so you can use Control+V to move it, i.e. paste it, elsewhere. (only available inside Nano)
+* Control+c: Copy the current line so you can use Control+V to paste it elsewhere. (only available inside Nano)
+* Control+v: Paste the current clipboard to the file. (only available inside Nano)
+* Alt+Space: Changes to the next file, if you have more than one open.
+* Control+Space: Changes to the previous file, if you have more than one open.
+* Control+f: Find text within the current document.
+* Control+h: Find and replace text in the current document.
+* Alt+c: Try to complete the current word. For this to work, the word you want to complete must already exist somewhere in the document.
+* Alt+m: Get character, line, and word count for the current document.
+
+Please note that the Nice Editor sometimes calls files "buffers". You can consider buffers the exact same thing as a file. The only reason this term is used, is because it refers to information that resides on memory and might not be already saved to disk.
+
+If you forget any of these commands, you can always find this text inside the Virtual Menu (Insert+F10), under the "Help" menu, under "About Nice Editor".
+

content/site/getting-started/03-04-language-switching.md

@@ -0,0 +1,6 @@
+## Fast Language Switching
+
+If you know more than one language, you can quickly switch between them with Fenrir. Press the Fenrir script key. The Script key is the Super key located between the left control and alt keys. Your Super key may have the Windows logo on it.
+
+To add a new language, or remove one, open "Configure fast language switching" located under the "Settings" menu.
+

content/site/getting-started/03-08-remote-assistance.md

@@ -0,0 +1,12 @@
+## Getting Remote Assistance
+
+If you are ever stuck, or have broken something and cannot figure out how to fix it, one of our team members may be able to help you. If you go to the help menu and select "Request remote assistance with my computer", a request for help will be issued to the F123 team.
+
+To get help simply write a brief description of the problem you have. To send the request, type . on a line by itself.
+
+Please note that this service is experimental at this point and is not yet available 24 hours a day, and for now, it is only available in English. In the near future we will share more details on time and language options in our lists and blog.
+
+### Important Notice on Remote Assistance
+
+Requesting remote assistance allows a team member full access to your computer. Anything the root user can do is available to the support staff who answers your request for assistance. You can request a log of everything done in the help session.
+

content/site/getting-started/03-09-basics-lists.md

@@ -0,0 +1,32 @@
+# Finding or Offering Help
+
+## Contributing Time, Talent, Contacts, Etc
+
+If you value the work we do, please help us out. You can help in many ways. here are some ideas:  
+
+* [Watch and like this video](https://youtu.be/KBM8Nq-f2T4) so we can win the Holman Prize and offer computer-building workshops in over 12 countries.
+* Tell a blind friend or blindness-related organization about us, this is our main page for F123Light: <https://guide.F123.org/>
+* [Donate a couple of hours a week as a volunteer](https://public.f123.org/F123-Seeks-Volunteers.html), [helping us with translations](https://crwd.in/f123light), proposal-writing, or marketing efforts.
+* Help with [software development](advanced.html)
+* [Buy the parts](https://f123.org/partes-f123light) or donate used equipment, and help a blind kid build his or her own talking computer.
+* Buy a talking computer and give it to a blind kid.
+* [Introduce us](mailto:information@f123.org?subject=Introducing F123) to a wealthy individual, foundation, or government agency that wants to assist the blind in their education, social inclusion, or employment prospects. Even though we prefer e-mail and dislike all types of social networks, if necessary and unavoidable, you can [introduce us using LinkedIn](https://br.linkedin.com/pub/fernando-botelho/5/a4a/6a2).
+* [Sponsor one of our courses or computer-building workshops](mailto:information@f123.org?subject=Sponsor F123).
+
+## Our E-mail Lists
+
+To join any of the following e-mail lists, you can send a blank e-mail message to the indicated address. You will then receive an e-mail message from the list, requesting confirmation. Just responding to that confirmation e-mail, i.e. pressing "reply" on your e-mail software, and sending the message without writing anything wil confirm and subscribe you to the list.
+
+If all you want is to get an occasional e-mail from us, sharing the latest news, [join our announcement list](mailto:f123light+subscribe@groups.io). The plan is to send just one message per month, maybe even less.
+
+* Technically inclined users who can communicate in English should subscribe e-mailing [F123e+subscribe@groups.io](mailto:F123e+subscribe@groups.io)
+* English speakers who are not developers or technically inclined, but are interested in the project for day-to-day use in note-taking, office work, project management, and other activities, subscribe by sending an e-mail to [F123-Visual-English+subscribe@groups.io](mailto:F123-Visual-English+subscribe@groups.io)
+* Non-technical users who speak Spanish can join our group by sending an e-mail message to [F123-Visual-espanol+subscribe@groups.io](mailto:F123-Visual-espanol+subscribe@groups.io)
+* Non-technical users who speak Portuguese can join by sending an e-mail message to [F123-Visual-portugues+subscribe@groups.io](mailto:F123-Visual-portugues+subscribe@groups.io)
+
+Those who want to keep in touch with the project through social networks, should know that we rarely respond to posts on social networks. Ideally, please get in touch with us via the above lists or via direct e-mail.
+
+## Contacting Our Team Directly
+
+Some messages are best sent directly to our team. E-mail [messages in English can be sent to this address](mailto:information@f123.org), [in Spanish to this address](mailto:informacion@f123.org), and [in Portuguese to this address](mailto:info@f123.org).
+