Help our university-BR project

PCA

Hello, greetings we are college Brazilian IT students, and we want to built an app Similar to Hands Free For Web.

Our project is based in accessibility, and we want to make web more easy to people.

So we are 1st grade and we don't know much about JavaScript, so if you could provide your code to us, so we can make an Brazilian version of it would help a lot.

Response so we can talk, thanks.

javi

Hi PCA

During the last year, I've been publishing the extension's modules, the extension code was built as a mono-repository and I'm trying to split it into several sub-modules. I haven't count them but I guess they are going to be like 50 modules plus the core. It will take me another year to make the entire codebase open source. At some point we'll get there.

In the meantime, the extension could be extended, everybody is able to add new modules supporting new voice commands or languages. i.e. Brasilian Portuguese.

If you want I'd love to help you to implement compatible modules, and if they are good additions I can include them as native modules of the extension.

Thanks for reaching me out and post in the forum

PCA

Yes. would be great you help us to extend the modules to Portuguese.

So we are begginers, what the previous knowledge we need to know to start implement the modules?
Can you help us from the very beginning if it's possible!

Thank you from Brasil

javi

I can help you since the beginning, it'd be great if we can work together and bring Portuguese support to the extension.

Here the following steps
1. Create a Github repository (language type javascript) - You
2. Upload to the repository empty translation files - Javi
3. Fill the translation files with the proper Portuguese translation -You
4. Load into the extension the new language translations - Javi

Required skills: Github, Git

In case you are also interested in support new kind of commands, i.e. "go to <your university name>"
it'd would require basic notions of javascript.

Could you bring more information about the university project? e.g. How many people will work in this project? What's the university name is? How long can you work on the project? What would you consider a big success for the project?

Thanks for being interested in accessibility projects
Javi

PCA

hello again, here is the Github repository - https://github.com/Unigranrio-pca/handsFreePt.js

Our university name is Universidade do Grande Rio or Unigranrio - RJ. There will be 5 people working on it, we have until middle june to complete the task, a big sucess would be, learn more from this experience, and provide accessibility to Brazilian people with a simple extension in their browser

We were think in add new commands like you said. i.e. "go to Unigranrio", just saying that and the site opens, with no google before, because when we tested the handsfree extension, and said "open a website facebook" a google search "Facebook" appears, not the site, we want to improve this feature to the extension, by adding famous sites like Globo (principal news site in brazil) and others.

Thanks

javi

Great!

I think we can achieve the goals by the end of May and improve everything in June to make it perfect.

Completed steps: yay
1. [DONE] Create a Github repository (language type javascript) - PCA

Following steps to do:
2. Assign repository collaborators - PCA
3. Upload to the repository empty translation files - Javi
4. Fill the translation files with the proper Portuguese translation -PCA
5. Load into the extension the new language translations - Javi

I'll need access to the Github repository. In the "Settings" section of the new repository, there is a subsection called "Collaborators". Could you add me as a collaborator? My GitHub username is "sljavi"

As soon as I get access to the repository I'll start adding the files with text in English to translate them to Portuguese.

In the meantime, you can start defining the new commands. i.e.
- When the user mentions "go to Unigranrio" the website "[URL_HERE]" is opened in a new tab.

If for some reason you have crazy ideas about voice commands don't hesitate to share them with me. I don't know if we could implement them but at least we could try or review and say why are hard to implement. Crazy voice commands examples
- "translate [words] to English"
- "where the Unigranrio is?" <- this is not so crazy 😉
- "share with twitter"

I'll review the type of commands you want to support and let you know how they can be implemented.

Have a great week

PCA

Cool

We just add you as colaborator, our group will discuss some features we can improve in your program, as son as we decide you'll be notified.

Have a nice day.

javi

Good morning PCA

I just uploaded several files with English texts to translate to Portuguese.
During the week I'll be adding the remaining files to translate (27).

let me know if you have any questions
Javi

PCA

Good afternoon

Javi our question is whether the files are to translate everything or in parts (if you specify please).

PCA.

javi

Hi PCA ,

I forgot to share the details,

The submitted files are javascript files that export a JSON structure. They are used by the extension to load the language translations.

In these files, you will find something like:

export default {
  pt: {
    'active-modules': 'Active Modules',
    'add-module': 'Add Module',
    'commands': 'Commands',
    'command': 'Command'
  }
}

Everything that is at the left side of : is a key name, and the language text is at the right.
if we want to translate this code to PT, it would look as

export default {
  pt: {
    'active-modules': 'Módulos Ativos',
    'add-module': Adicionar Módulo',
    'commands': 'Comandos',
    'command': 'Comando'
  }
}

Note: I have used google translate to translate the words, they might not be good translations.

As soon as all the translations are ready, I'll load them into the extension, and you will be able to review them.

PCA

Hi we add some commits in a new branch on the GitHub, you can check if everything is alright and tell us about.

We were searching, and I didn't see a print screen feature, and we want to improve this, when you say the comand "print screen" the program takes a picture of the screen, and save in the "ctrl + v" for the user can paste in Facebook, Whatsapp etc.
If the feature is avaiable and we dind't find, tell us.

Good monday.

javi

I just reviewed the translations and they look great! I'll try to push to the master branch all the files to translate this evening.

Technically speaking the missing feature you are proposing requires to save an image in the clipboard. I think it's a very good idea. I'll review if it is something that Google Chrome allows us to implement.

PCA

Hey,

The translation is going well, we are trying to make a pattern in the translation, so I think is going very well.

About that, one question for you. We noticed in first time that we are translation directly the interface of the extension, only text and instructions on how to use the program. The people who only speak portuguese, can say "Pesquisar" instead of saying "Search"?
Like in the spanish version, we can say "Busca" rather than "Search".

Do you know what I mean? tell me if you have any questions

Good Morning.

javi

PCA

Good morning! I glad to see the translations are going well.

The translations you are working on are for:
- Voice commands (the key name is command.*)
- Commands descriptions (the key name is help.*)
- Command group names (the key name is group.*)
- Module names (the key name is name)
- Module descriptions (the key name is description)
- Random texts that are used in the interface

I think it is ok to use "Pesquisar" as a translation of "Search", it depends on what it sounds more natural to you. Let's imagine you are close to a friend that is using a computer. When you need to tell him to search for something, would you use "Pesquisar" or "Busca"?

As soon as you tell me that the translations are done or almost done, I can load them into the tool and release it. You will be able to play with the extension and find translations to improve. Let's say you are working in the 1.0.0 version of them and later we'll be able to improve them as much as you want them.

Thanks!

PCA

Greetings, we have great news , just finished translate the files and reviwed all of them.

We have until the end of this month to show the program working or some prototype, so we would be very thankful if we could finish the first versions at this month, and give a Brazilian feeling in this project.

Good weekend!!!

javi

Wonderful news!

I'll be adding the translations to the app.
If everything goes well I can release the new version of the extension next Thursday.

I just checked the repository, could you merge the changes into the master branch ?

Thanks!

PCA

Just merged, if u have any problem with the translations contact us.

it was a lot of work, trying not just translate but giving the right word for people can understand more easily, we'll be grateful if everything goes well.

Thanks

javi

I have great news for you PCA

I just released the extension with all the translations you have provided, sadly I don't speak Portuguese, so I can't play with the new language support, but it looks great. I think you have made a great work translating all those voice commands and texts.

Could you help me to test the new language support? Here some test cases to make
- Install the extension for the first time and check that PT language is selected by default. (this will happen only if your browser is also in Portuguese)
- Check the admin section's texts and the commands module's texts
- Use the modules section of the dashboard to play with the voice commands as the help texts suggest
- Navigate some websites and see if the voice commands are ok

Some of the examples in the dashboard are not translated, I have missed to include them in the repository. I will be pushing them tomorrow, they are not so many lines, I think they will be less than 50.

If you find something to improve don't hesitate to share it.

Let me know your thoughts!
Javi

PCA

Awesome news!

We'll be testing until next Week and if we find some issues and something to improve I'll be making a PDF and send to you with things to change.

PDF because is more easy to understanding with prints about some bugs or missing things, if you agree with that see you soon

Thanks

javi

PCA

Great! Yes, a PDF, doc, or google doc would be great.

I've pushed to the repository the missed texts to translate, you can see them here
https://github.com/Unigranrio-pca/handsFreePt.js/commit/1c6ad2962c64fd44ee69e9e032e3a87a5ac2e34b

The missed texts to translate are for:
- Help examples below the voice command descriptions -> it will finish the renaming admin page translations
- Chrome extension's page -> it will allow people that talk in Portuguese to search for the extension in Chrome Store
- Home page of the website of Handsfree for web -> It will show to people that visit the webpage that Portuguese is supported

There are not so many, I hope you can translate them

Back to our to-do list:

Completed steps: yay
1. [DONE] Create a Github repository (language type javascript) - PCA
2. [DONE] Assign repository collaborators - PCA
2. [DONE] Assign repository collaborators - PCA
3. [DONE] Upload to the repository empty translation files - Javi
4. [DONE] Fill the translation files with the proper Portuguese translation - PCA
5. [DONE] Load into the extension the new language translations - Javi

Following steps to do:
6. Test Portuguese version of the extension and report errors - PCA
7. Translate the second group of texts - PCA
8. Load second group of translations into the extension, extension page and web page - Javi

I'd love to add you as contributors in some places, website, and extension page. If you don't mind, could you post your names?

I think it's time also to start thinking on the voice commands you wanted to add. I was doing some research about how to copy to the clipboard a screenshot. I'm afraid that won't be possible, at least easily, the API that will help to make that is still not supported by Google Chrome.
https://developer.mozilla.org/en-US/docs/Web/API/Clipboard/write

We can explore other voice commands to make anyway.

Have a great weekend