Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleThe batch upload process for the new FirstVoices is being redesigned. Click here to reference the old steps...

1. Before you start

As a team, decide on what information you want to include as part of your batch upload. In general, the more information you can provide, the more useful the language site will be in the future, but the longer the batch may take to prepare.

For example:

  • Just the basics:

    • word/phrase in your language, and its translation (for words/phrases)

    • alphabet characters and their order (for alphabet characters)

  • Sample pronunciation audio for each word, phrase, or alphabet character

  • A part of speech (words only)

  • A reference or citation

  • Additional explanatory notes

2. Review file-naming requirements

If you are submitting media files such as audio recordings, you will need to prepare your files in a specific way so that they can be accepted by our uploader. Our batch uploader is not as flexible as the FirstVoices website, and has more restricted file name requirements.

Note

Spaces and special characters are NOT PERMITTED in any files or folders to be uploaded.

The ONLY accepted symbols are letters (a-z, A-Z), numbers (0-9), hyphen (-), underscore (_).

Please keep this in mind and make sure that ALL files and folders you submit follow these rules.

Not accepted:

Try this:

Basic letters and numbers only!

Warning

20200131-gṑdan.wav

Tip

20200131-go-1dan.wav

Replace special letters, including letters with diacritics, with the basic Roman letters (a-z), or come up with your own conventions.

No spaces!

Warning

2018 Joe Smith ahthenno.mp3

Tip

2018_Joe-Smith_ahthenno.mp3

Replace any spaces with - (hyphen) or _ (underscore)

No other special characters!

Warning

1.ha'a~martha&bill.wav

Tip

1_ha7a_martha-bill.wav

Periods, apostrophes, and other symbols can be replaced with hyphens, underscores, or letters/numbers.

Note

Note: MP3 files are smaller and are the preferred choice for uploading to FirstVoices and for downloading. WAV files can be used for master copies.

3. Create your spreadsheet

The batch spreadsheet captures the metadata and documentation about your files and is required for the batch upload. You'll need a spreadsheet application to proceed with this step.

Info

The FirstVoices team recommends Open Office because it handles the Indigenous special characters best. You can download Open Office for free at https://openoffice.apache.org/.

  1. Review the specific preparation instructions for the kind of batch you are working on:

  2. From the “Resources” section of the instructions page, download a template spreadsheet and save it on your computer.

  3. Open the template spreadsheet on your computer. If you are using Open Office, ensure that ONLY the box next to "Comma" is checked before clicking OK.

    Screenshot of the Open Office settings text import settings window, with an arrow pointing to the option Separated by - Comma, which is the only one checked
  4. (Optional) Add or remove columns in the spreadsheet to match the field information you plan to upload.

    1. If there are optional columns in the template that you do not plan to use, you can delete or “hide” them. For example, you can delete columns relating to image files if you are not using them.

    2. You can add additional columns to the template if you wish. Please note that your additional columns WILL NOT BE UPLOADED unless the column header matches a column listed in the instructions.

    3. DO NOT change the names of the column headers in the template.

  5. Enter your data into the appropriate columns below the headers. Take great care to avoid typos. Any errors you make in the content of this spreadsheet will be uploaded to your FirstVoices language site or may affect the success of the upload.

  6. When you are finished and ready to save, save your spreadsheet in CSV UTF-8 (Comma delimited) (.csv) file format.

    1. Give the file a practical name with no spaces or special characters, following the rules in step 2.
      Example: denekeh_september_2019_words.csv

    2. Do NOT save as an Excel file (.xlsx) or a regular Comma Separated Values (.csv) – these cannot be processed and may break special characters in your data.

More information on saving your spreadsheet with correct Indigenous special characters can be found here: (New) Save spreadsheets in UTF-8 CSV format

4. Prepare your media files

  1. To include media files in the upload, copy your audio and other media files into one folder on your computer.

  2. Give the folder a practical name related to your batch. The name should follow the rules in step 2 (e.g. NO SPACES.)
    Example folder: denekeh_september_2019_words_media

  3. Name your media files using the same format. The names should follow the rules in step 2. (e.g. the only special character should be the period before the file type, such as .mp3 or .wav). 
    Example filename: 2018_joe_smith_word1.mp3

  4. Enter the exact filename of the media into your spreadsheet where it belongs, along with other information such as the title.

5. Double-check all your files and the spreadsheet

It's important to make sure your files, metadata and documentation are correct before you submit them. Take particular care to match the filenames in your spreadsheet exactly as they have been named in your folder. Any typos in filenames may affect that row being successfully uploaded.

Work with your language team to double-check and proofread all entries before sending them in. You may wish to send it to another team member, who can open it up and make sure it saved correctly.

Note

Once the batch upload has been submitted, any errors from typos will need to be fixed individually online by your team.

6. Send to the FirstVoices team for processing

Format your spreadsheet and media folder as such:

Format

Example

Spreadsheet

sitename_month_day_year_[words/phrases].csv

ktunaxa_august_2_2021_words.csv

Media folder

sitename_month_day_year_[words/phrases]_media.zip

ktunaxa_august_2_2021_words_media.zip

If your upload is large and cannot be attached by email, you can upload these files to FPCC’s custom Sharepoint in a folder designated for your team. To set this up or get access to the link, email hello@firstvoices.com.

It is ok to zip your folder of media files for easier upload.

Info

How to zip your media files on a Mac

  • Locate the folder to zip

  • Right-click on the folder

  • Click "Compress"

  • Find the newly created .zip archive in the same location on your computer

Info

How to zip your media files on a PC

  1. Locate the folder to zip.

  2. Right-click on the folder

  3. Click "Send to" and then click "Compressed (zipped) folder"

  4. Find the newly created .zip archive in the same location on your computer

Once the upload is complete, email batch@fpcc.ca with your files attached, or by letting us know that you uploaded them to Sharepoint. The subject of the email should match the name of your spreadsheet – so for example, if the spreadsheet you uploaded was ktunaxa_august_2_2021_phrases.csv, that should be your email subject.

Note

Please note that it may take us longer than usual to process your batch uploads, as our FirstVoices development team capacity has been significantly reduced. If you don't hear back in the normal 1-2 week time period after sending us a batch upload, please don't be concerned — our team is working diligently to get them completed in a timely manner, and your batch will be responded to and processed as soon as possible.

If you normally send multiple batches per month, we would appreciate it if you would consider sending one larger batch per month instead. This would reduce the amount of time it takes for us to process multiple batches, and speed up the process for everyone.

7. Review uploaded content

Once FirstVoices staff has uploaded your content, we will notify you by email.

Then, you should review the new content to make sure it uploaded correctly. For words/phrases, the entries will be visible only to your language team until you approve them.

Congrats, you have uploaded a batch!

Tip

Workflow Tips

  • Always keep your original media files in a safe, secure place. Servers and password-protected external hard drives are always good places to keep a back-up.

  • It's important to have a workflow that clearly identifies new entries from ones that have already been uploaded. One easy way to do this is to move files to a folder marked DONE or UPLOADED after uploading.