Like Khan Academy but more more more simple and always with drag and drop things.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 3.6KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
  1. # my-drag-and-drop-khan-academy
  2. ## Name
  3. For brevity, just say *mdadak* (My Drag And Drop Academy Khan). And don't ask me how you have to pronunce it: how you want ;-).
  4. Originally the name of the repository had a typo in the name: it's "Kahn Academy". But when I create the repository, I don't remember exactly the name and... I will not change that. It serves for see we are different of Khan Academy ;-) Now it's corrected.
  5. ## Intentions
  6. * Like Khan Academy but more more more simple and always with drag and drop things.
  7. * Not compete with Khan Academy. Complement it.
  8. * The intention is to have **minimal** and **portable** framework for writting, essentially, drag and drop questions and answers quizzes (eg. identifying the parts of the human cell)
  9. ## State
  10. The state is rudimentary, but functional.
  11. ## Development language
  12. My native language is catalan. So catalan is the development language of this project. This means that commits, notes and variables in source code are, mostly, in catalan. Minor documents could be also in cataln. But I hope the code is good enough to anyone could understand, modify and adapt to his/her language and context.
  13. ## License
  14. The software is licensed under the ["MIT License"](http://en.wikipedia.org/wiki/MIT_License) and the content on this site, except where otherwise noted, is licensed under a ["Creative Commons Attribution 4.0 License"](http://creativecommons.org/licenses/by/3.0/). For more information see `LICENSE.md` file.
  15. ## Structure of the project
  16. There are two sets of exercises, that I maintain in two separate git branches:
  17. * "master branch": contains *all* exercises, good or bad, revised or not.
  18. * "gh-pages branch": there are only the *worthy* and revised exercises. The exercises of "gh-pages" *were* accessible via web [here](http://somenxavier.github.com/my-drag-and-drop-kahn-academy/) (not now). So the set of exercises of gh-pages is a subset of the set of exersises of master branch formed by good enough ones.
  19. ## Directories
  20. * In "./stylesheets" there are CSS files for general presentation of pages. It's mainly used in gh-pages branch.
  21. * In "./docs" there are docs about project: greetings (in catalan), history (in catalan), Instructions for adapt and modify the exercises (for fit to your needs), etc.
  22. * In "./exers" there are the exercises. Each exercise has specific CSS and javascript within. There is also one example exercise (template exercise).
  23. ### Pattern of files
  24. For convention, I group the exercises by units or themes. Each unit is a directory which has the name `{number}-{name of the unit}` (example `01-cell` corresponds to the unit 01 Cell). The number has no meaning but cronologically order.
  25. In each unit directory, I name the exercise files by this way: `{unit name}-{number of exercise}-{abreviation of the language of the exercise}.html`. The abreviation of the language belongs to [ISO 639-1 code](http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).
  26. ## History and greetings
  27. If you are interested in the history of the project, you can read [here](https://github.com/somenxavier/my-drag-and-drop-kahn-academy/blob/master/docs/Història.md) (in catalan). By the other hand, there is a [file](https://github.com/somenxavier/my-drag-and-drop-kahn-academy/blob/master/docs/Agraïments.md) of greetings (also in catalan).
  28. ## Participation
  29. If you want to submit some exercises to me, please do it. I will analyse, and, if I like those, I will be glad to add to my project. Otherwise, you could fork my project.
  30. You can also warn me about typos or grammatical errors in english. As I noted above, it's not my native language.