Skip to content

mcomz-org/MComzLibrary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MComzLibrary

Offline knowledge library that ships pre-installed with MComzOS.

What's in it

Three book collections (ZIM files) of freely redistributable content:

ZIM Contents Texts
MComz-Survival.zim Medical, survival, civil defence, engineering, communications, water and sanitation 18
MComz-Literature.zim Classic literature for morale, education, and younger readers 27
MComz-Scriptures.zim Religious and philosophical texts from seven major world traditions 12

Each ZIM opens to a welcome page generated from the matching docs/intros/INTRO_<CAT>.md. The intro is the contents listing - edit the prose, rebuild, and the ZIM picks it up.

Curation philosophy

Sustainable Survival - the ability for you and your family to thrive without impacting the ability of others to thrive, now or in the future.

Every text is selected on those terms, to help communities move from crisis through recovery to long-term self-sufficiency.

Contents

Each collection's selection notes - why each text earned its place, and what we excluded and why - live in the linked intro file. Title links below go to a clean online reader where one exists; the ZIM bundles everything regardless.

Survival (selection notes)

Medical

Survival, navigation, civil defence

Communications, rigging, mechanics, electrical

Water and sanitation

Literature (selection notes)

Scriptures (selection notes)

Building

Requires zim-tools (for zimwriterfs) and pandoc.

git clone https://github.com/MComz-org/MComzLibrary.git
cd MComzLibrary
./scripts/download-sources.sh    # idempotent; failures listed in download-failures.txt
./scripts/build-zims.sh          # outputs to dist/

A monthly GitHub Actions workflow (.github/workflows/build-zims.yml) runs the same pipeline on the 1st of each month and publishes a prerelease tagged vYYYY.MM.DD with the three ZIMs attached.

Adding a source

One entry in scripts/download-sources.sh and one row in the matching docs/intros/INTRO_<CAT>.md table. Selection criteria - licence, language, relevance - are in docs/RATIONALE.md.

Documentation

Contributing

Contributions welcome, especially:

  • Translations - help produce ZIMs in other languages.
  • Regional foraging guides - public-domain texts for your region.
  • Licence verification - help confirm redistribution terms for sources we haven't cleared.
  • Content suggestions - public-domain or CC BY / CC BY-SA texts that fit Sustainable Survival.

Please open an issue before starting on anything large.

Coming soon

  • Publishing the ZIMs via the Kiwix public library so anyone can install Kiwix on their phone and pull at least WikiMed Mini plus the three MComz ZIMs once available. Until then, all four are pre-installed with every MComzOS installation.
  • WHO Psychological First Aid Guide in Survival - mental-health triage alongside Stop the Bleed and CPR. The section in INTRO_SURVIVAL.md is empty pending this. Subject to permission from WHO.
  • Hesperian's Where There Is No Doctor and four companion titles in Survival - the standard field reference for clinics without doctors. Subject to permission from Hesperian.
  • Sphere humanitarian minimum standards in Survival - the handbook used by humanitarian responders for shelter, WASH, food security, and health. Subject to permission from Sphere.
  • Four further Literature classics - Panchatantra, Waley's Monkey, a condensed Ramayana, Sa'di's Gulistan. Parked until clean public-domain sources or permissions are in hand.

Licence

The ZIM files contain no NC-licensed material, so they can be freely redistributed, remixed, and built upon. Individual source texts retain their original licences (noted in the Rationale).

Repository tooling and documentation: MIT.


Martin's input, lovingly crafted in Scotland with vibe.

About

Offline library ZIM files for MComzOS — spiritual texts, literature, and survival/medical references

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages