Your SlideShare is downloading. ×
0
HOW TOHERD CATSTATUES& MAKEAWESOMETHINGSMELISSA DRAPERKIWIPYCON 2012                 flickr.com/photos/schristia/4366659009/
A story of 3 users.
Jack found a useful  sounding tool...
...but cant figure itout.
Jack looks fordocumentation
A lack ofdocumentation is    bad.
Jill found a usefulsounding tool too.
It has documentation!
So she will use it.
Gooddocumentation tells people how to use   your product.
Jaques found auseful tool too
¿Qué?
Excellentdocumentation is  available for   everyone.
Mahara(mah-hah-rah; verb) To think, thinking,      thought
Open Source Eportfolio
Students and Educators
Comprehensive user manual.
In English.
Requirements:
Low learning curve  for translators.
One set of rST     source(per software version)
Images need to be  translated too!
Support multiplenon-latin scripts(and unicode symbols)
OOB Sphinx does not really do this!(it kind of does Japanese)
p.s. Really, nothing    does all this
How to make Sphinx    do magic?
Makefile-driven
Get the translations:
Automagicallyimport translations
Launchpad         ↓     msgfmt         ↓Sphinx (via gettext)
Swap to XeLaTeX:
Good old fashioned    patching      ಠ_ಠ
General patches
Locale patches
Unsupported locales
Localised images:
Localised images git submodule
Copy images overbefore each build.
Standardise DPI
$(foreach TRANSLATION,$(UNSUPPORTED),              mkdir -p source/locales/$(TRANSLATION)/$(MAHARA)/LC_MESSAGES;          ...
gitorious.org/mahara/manual
Disclaimer: Not perfected yet.
How to herd cat statues and make awesome things
How to herd cat statues and make awesome things
How to herd cat statues and make awesome things
How to herd cat statues and make awesome things
How to herd cat statues and make awesome things
Upcoming SlideShare
Loading in...5
×

How to herd cat statues and make awesome things

108

Published on

Published in: Technology, Business
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
108
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
1
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "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.
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×