https://github.com/aekasitt/zines

Translation boilerplate for and booklet app for educational pamphlets for Bitcoin and cypherpunk technologies
https://github.com/aekasitt/zines

bips bitcoin bitcoin-improvement-proposals payjoin zine

Last synced: about 1 year ago
JSON representation

Translation boilerplate for and booklet app for educational pamphlets for Bitcoin and cypherpunk technologies

• Host: GitHub
• URL: https://github.com/aekasitt/zines
• Owner: aekasitt
• License: mit
• Created: 2023-05-04T18:11:05.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2025-05-02T09:46:30.000Z (about 1 year ago)
• Last Synced: 2025-05-02T10:48:35.899Z (about 1 year ago)
• Topics: bips, bitcoin, bitcoin-improvement-proposals, payjoin, zine
• Language: CSS
• Homepage: https://aekasitt.github.io/zines/
• Size: 29.8 MB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Zines

[![Bitcoin-only](https://img.shields.io/badge/bitcoin-only-FF9900?logo=bitcoin)](https://twentyone.world)

[![Top](https://img.shields.io/github/languages/top/aekasitt/zines)](https://github.com/aekasitt/zines)

[![Languages](https://img.shields.io/github/languages/count/aekasitt/zines)](https://github.com/aekasitt/zines)

[![Last commit](https://img.shields.io/github/last-commit/aekasitt/zines/master)](https://github.com/aekasitt/zines)

![Zines Banner](static/zines-banner.svg)

For bitcoiners far & wide, I created this to translate a short zine on BIPs created by the half-Thai

half-awesome (same half) [@satsie](https://github.com/satsie) found [here.](https://satsie.dev/bips)

This repository is meant to be used with Visual Studio Code with the recommended extension

* `yzane.markdown-pdf` listed in recommended extensions

  (repository: [vscode-markdown-pdf](https://github.com/yzane/vscode-markdown-pdf) by [@yzane](https://github.com/yzane))

## Current roster

- All about BIPs

  * [🇬🇧](./bips.md) - [pdf](./bips.pdf)

  * [🇹🇭](./bips.th.md) - [pdf](./bips.th.pdf)

  * [🇪🇸](./bips.esp.md) - [pdf](./bips.esp.pdf)

- Payjoin

  * [🇬🇧](./payjoin.md) - [pdf](./payjoin.pdf)

  * [🇹🇭](./payjoin.th.md) - [pdf](./payjoin.th.pdf)

## Usage

1. Create a copy from the Markdown file, for example we will use `bip.md` containing original

  contents to your desired language. (Recommend renaming to `bip.xx.md` with xx denoting language,

  following after Thai translated zine convention, `bip.th.md`)

1. One paragraph at a time, translate the contents of the "All about BIPs" zine to desired language.

1. Use the command palette to turn your new markdown `bip.xx.md` to PDF file ready for print.

1. Hand out at local conferences and meetups. New bitdevs are found everywhere.

### Command Palette

1. Press `F1` or `Ctrl+Shift+P`

1. Type `export` and select below

   * `Markdown PDF: Export (pdf)`

1. Sometimes hangs. When unsuccessful, try try again.

1. Voila!

### Tips

1. Use `` tag in your translation to inject "bitcoin" with original branding

  using bold and italicized Ubuntu font.

## Demonstration

![demonstration](./static/demo.gif)

### Acknowledgements

1. "Mali" typeface by [Cadson Demak](https://github.com/cadsondemak/Mali) licensed by

  `SIL Open Font License 1.1` being used on default English version and  Thai translations.

1. "Coffee and Crafts" typeface by [Misti's Fonts](https://mistifonts.com/coffee-and-crafts/)

  licensed by `SIL Open Font License 1.1` being used on some vector assets like Payjoin coins.

1. `bitcoin` logo font "Ubuntu" by [Dalton Maag](https://design.ubuntu.com/font)

  `...distributed under an open licence and you are expressly encouraged to experiment, modify, share and improve.`

1. [HereComesBitcoin](https://www.herecomesbitcoin.org/) for vector character assets

1. [SVGRepo](https://www.svgrepo.com/) and [Freepik](https://freepik.com) for various vector assets

## License

This project is licensed under the terms of the MIT license.