Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

How to herd cat statues and make awesome things

265 views

Published on

Published in: Technology, Business
  • Be the first to comment

  • Be the first to like this

How to herd cat statues and make awesome things

  1. 1. HOW TOHERD CATSTATUES& MAKEAWESOMETHINGSMELISSA DRAPERKIWIPYCON 2012 flickr.com/photos/schristia/4366659009/
  2. 2. A story of 3 users.
  3. 3. Jack found a useful sounding tool...
  4. 4. ...but cant figure itout.
  5. 5. Jack looks fordocumentation
  6. 6. A lack ofdocumentation is bad.
  7. 7. Jill found a usefulsounding tool too.
  8. 8. It has documentation!
  9. 9. So she will use it.
  10. 10. Gooddocumentation tells people how to use your product.
  11. 11. Jaques found auseful tool too
  12. 12. ¿Qué?
  13. 13. Excellentdocumentation is available for everyone.
  14. 14. Mahara(mah-hah-rah; verb) To think, thinking, thought
  15. 15. Open Source Eportfolio
  16. 16. Students and Educators
  17. 17. Comprehensive user manual.
  18. 18. In English.
  19. 19. Requirements:
  20. 20. Low learning curve for translators.
  21. 21. One set of rST source(per software version)
  22. 22. Images need to be translated too!
  23. 23. Support multiplenon-latin scripts(and unicode symbols)
  24. 24. OOB Sphinx does not really do this!(it kind of does Japanese)
  25. 25. p.s. Really, nothing does all this
  26. 26. How to make Sphinx do magic?
  27. 27. Makefile-driven
  28. 28. Get the translations:
  29. 29. Automagicallyimport translations
  30. 30. Launchpad ↓ msgfmt ↓Sphinx (via gettext)
  31. 31. Swap to XeLaTeX:
  32. 32. Good old fashioned patching ಠ_ಠ
  33. 33. General patches
  34. 34. Locale patches
  35. 35. Unsupported locales
  36. 36. Localised images:
  37. 37. Localised images git submodule
  38. 38. Copy images overbefore each build.
  39. 39. Standardise DPI
  40. 40. $(foreach TRANSLATION,$(UNSUPPORTED), mkdir -p source/locales/$(TRANSLATION)/$(MAHARA)/LC_MESSAGES; cp -n /usr/share/locale-langpack/en_AU/LC_MESSAGES/sphinx.mo source/locales/$(TRANSLATION)/$(MAHARA)/LC_MESSAGES/sphinx.mo ;) $(foreach TRANSLATION,$(TRANSLATIONS), git checkout source/images ; cp -ra localeimages/$(TRANSLATION)/* source/images ; /bin/bash convert_images_dpi.sh; $(SPHINXBUILD) -a -D language=$(TRANSLATION) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA); cp patches/makesty.patch $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA); cp patches/tex.patch $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA); patch --directory=$(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) -p1 < $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/makesty.patch; patch --directory=$(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) -p1 < $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/tex.patch ;) $(foreach TRANSLATION,$(CLEAN), make -C $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) all-pdf-ja ;) $(foreach TRANSLATION,$(PATCHED), cp patches/$(TRANSLATION).patch $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA); patch --directory=$(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) -p1 < $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/$(TRANSLATION).ch; make -C $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) all-pdf-ja; patch -R --directory=$(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) -p1 < $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/$(TRANSLATIONch ;) $(foreach TRANSLATION,$(TRANSLATIONS), patch -R --directory=$(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) -p1 < $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/tex.patch; patch -R --directory=$(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) -p1 < $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/makesty.patch; cp $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/Mahara.pdf $(BUILDDIR)/html/$(TRANSLATION)/$(MAHARA)/Mahara.pdf; rm -r $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/ ;) git checkout source/images
  41. 41. gitorious.org/mahara/manual
  42. 42. Disclaimer: Not perfected yet.

×