how to herd cat statues and make awesome things
DESCRIPTION
TRANSCRIPT
![Page 1: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/1.jpg)
HOW TOHERD CATSTATUES& MAKEAWESOMETHINGSMELISSA DRAPERKIWIPYCON 2012
flickr.com/photos/schristia/4366659009/
![Page 2: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/2.jpg)
A story of 3 users.
![Page 3: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/3.jpg)
Jack found a useful sounding tool...
![Page 4: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/4.jpg)
...but can't figure it out.
![Page 5: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/5.jpg)
Jack looks for documentation
![Page 6: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/6.jpg)
![Page 7: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/7.jpg)
A lack of documentation is
bad.
![Page 8: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/8.jpg)
Jill found a useful sounding tool too.
![Page 9: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/9.jpg)
It has documentation!
![Page 10: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/10.jpg)
So she will use it.
![Page 11: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/11.jpg)
Good documentation tells people how to use
your product.
![Page 12: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/12.jpg)
Jaques found a useful tool too
![Page 13: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/13.jpg)
¿Qué?
![Page 14: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/14.jpg)
![Page 15: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/15.jpg)
Excellent documentation is
available for everyone.
![Page 16: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/16.jpg)
![Page 17: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/17.jpg)
![Page 18: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/18.jpg)
![Page 19: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/19.jpg)
Mahara(mah-hah-rah; verb)To think, thinking,
thought
![Page 20: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/20.jpg)
Open Source Eportfolio
![Page 21: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/21.jpg)
Students and Educators
![Page 22: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/22.jpg)
Comprehensiveuser manual.
![Page 23: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/23.jpg)
In English.
![Page 24: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/24.jpg)
Requirements:
![Page 25: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/25.jpg)
Low learning curvefor translators.
![Page 26: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/26.jpg)
One set of rST source
(per software version)
![Page 27: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/27.jpg)
Images need to be translated too!
![Page 28: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/28.jpg)
Support multiple non-latin scripts
(and unicode symbols)
![Page 29: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/29.jpg)
OOB Sphinx does not really do this!
(it kind of does Japanese)
![Page 30: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/30.jpg)
p.s. Really, nothing does all this
![Page 31: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/31.jpg)
How to make Sphinx do magic?
![Page 32: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/32.jpg)
Makefile-driven
![Page 33: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/33.jpg)
Get the translations:
![Page 34: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/34.jpg)
Automagically import translations
![Page 35: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/35.jpg)
Launchpad↓
msgfmt↓
Sphinx (via gettext)
![Page 36: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/36.jpg)
Swap to XeLaTeX:
![Page 37: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/37.jpg)
Good old fashioned patching
ಠ_ಠ
![Page 38: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/38.jpg)
General patches
![Page 39: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/39.jpg)
Locale patches
![Page 40: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/40.jpg)
Unsupported locales
![Page 41: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/41.jpg)
Localised images:
![Page 42: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/42.jpg)
Localised imagesgit submodule
![Page 43: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/43.jpg)
Copy images overbefore each build.
![Page 44: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/44.jpg)
Standardise DPI
![Page 45: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/45.jpg)
$(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).
patch; \make -C $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) all-pdf-ja; \patch -R --directory=$(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA) -p1 < $(BUILDDIR)/latex/$(TRANSLATION)/$(MAHARA)/$(TRANSLATION).
patch \;)$(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
![Page 46: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/46.jpg)
gitorious.org/mahara/manual
![Page 47: How to herd cat statues and make awesome things](https://reader033.vdocuments.site/reader033/viewer/2022051514/54c209434a795915208b456a/html5/thumbnails/47.jpg)
Disclaimer: Not perfected yet.