https://github.com/artyom-poptsov/SPARC
Science, Programming, Art and Radioelectronics Club (SPARC) book.
https://github.com/artyom-poptsov/SPARC
arduino book electronics music-programming
Last synced: 3 months ago
JSON representation
Science, Programming, Art and Radioelectronics Club (SPARC) book.
- Host: GitHub
- URL: https://github.com/artyom-poptsov/SPARC
- Owner: artyom-poptsov
- License: cc-by-sa-4.0
- Created: 2022-10-01T16:12:20.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-21T17:29:37.000Z (8 months ago)
- Last Synced: 2024-10-22T07:34:31.865Z (8 months ago)
- Topics: arduino, book, electronics, music-programming
- Language: TeX
- Homepage:
- Size: 18.2 MB
- Stars: 34
- Watchers: 7
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README
- Changelog: ChangeLog
- License: COPYING
- Authors: AUTHORS
Awesome Lists containing this project
- trackawesomelist - Science, Programming, Art and Radioelectronics Club (SPARC) (⭐46) - Artyom V. Poptsov (PDF) (CC BY-SA) (Recently Updated / [Mar 09, 2025](/content/2025/03/09/README.md))
README
* Science, Programming, Art and Radioelectronics Club (SPARC) book
[[https://github.com/artyom-poptsov/SPARC/actions/workflows/pdf.yaml/badge.svg]]
This =README= is also available in other languages: [[./README.ru.org][ru]]
A book dedicated to the connection of science, programming, art and radio
electronics as part of independent studies or for conducting clubs and practical
sessions on microcontroller programming.
** License
This work is distributed under the terms of the Attribution-ShareAlike license
«Attribution-ShareAlike» 4.0 Worldwide (CC BY-SA 4.0)
(https://creativecommons.org/licenses/by-sa/4.0/deed.ru)
The book uses images created by [[https://thenounproject.com/][The Noun Project]], which are located in the
public domain or under a Creative Commons license.
** Installation
*** Manual Installation
The Installation is done via GNU Autotools:
#+BEGIN_EXAMPLE shell
$ git clone https://github.com/artyom-poptsov/SPARC.git
$ cd SPARC
$ autoreconf -vif
$ ./configure
$ make -j$(nproc)
#+END_EXAMPLE
This set command builds the English and the Russian version of the book.
To build only the English version of the book, the following command can be
used:
#+BEGIN_EXAMPLE shell
$ make -j$(nproc) en
#+END_EXAMPLE
You can clear the directory of generated files using the command:
#+BEGIN_EXAMPLE shell
$ make clean
#+END_EXAMPLE
*** GNU Guix
Build and install the version from the repository (the book will be located in
=~/.guix-profile/share/doc/sparc/sparc.pdf=):
#+BEGIN_EXAMPLE shell
guix package -f guix.scm
#+END_EXAMPLE
To generate the book, it is convenient to use Guix Shell:
#+BEGIN_EXAMPLE shell
guix shell --pure -D -f guix.scm
make -j$(nproc)
#+END_EXAMPLE
*** Ubuntu GNU/Linux 22.04
Installing dependencies from the repository:
#+BEGIN_EXAMPLE shell
sudo apt update
sudo apt install -yqq \
git \
automake \
make \
lilypond \
biber \
fonts-liberation \
texlive-full \
python3-pygments \
inkscape
#+END_EXAMPLE
Installing the Lilyglyphs package:
#+BEGIN_EXAMPLE shell
cd /tmp/
wget https://mirrors.ctan.org/macros/unicodetex/latex/lilyglyphs.zip
unzip lilyglyphs.zip
sudo cp -r ./lilyglyphs/tex/* /usr/share/texmf/tex/latex/
sudo mktexlsr
#+END_EXAMPLE
The rest of the assembly can be done manually, as shown above.