Skip to content
Snippets Groups Projects
Commit f1fb298e authored by matograine's avatar matograine
Browse files

Passage à Sphinx come formatteur.

parent f64b4a8a
No related branches found
No related tags found
No related merge requests found
Showing
with 1555 additions and 20 deletions
default: convert
convert:
bash publication.sh
clean:
git:
# git add files
#git add whitepaper.md whitepaper.html
#git add chapters/1_intro.md.txt chapters/2_looking_at_Bitcoin.md.txt chapters/3_blockchain.md.txt chapters/4_Web_Of_Trust.md.txt chapters/5_individualized_difficulty.md.txt chapters/6_conclusion.md.txt chapters/9_sources.md.txt
#git add publication.sh
#we want to add the .pdf only for publication
# git add whitepaper.pdf
# Minimal makefile for Sphinx documentation
#
# You can set these variables from the command line, and also
# from the environment for the first two.
SPHINXOPTS ?=
SPHINXBUILD ?= sphinx-build
SOURCEDIR = source
BUILDDIR = build
# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
.PHONY: help Makefile
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
......@@ -4,20 +4,17 @@ Rédaction d'un Whitepaper pour le projet Duniter.
Je ne suis pas compétent pour entrer dans les détails du projet. Cependant, je le suis assez pour rédiger la majeure partie du texte explicatif. J'invite qui le souhaite à m'accompagner dans cette rédaction.
## Installation et compilation sur système Debian
Les sources sont rédigées en syntaxe RestructuredText et compilées avec Sphinx.
Pour compiler les sources markdown vers les versions html, ebook et pdf vous allez avoir besoin de ces dépendances:
```bash
sudo apt install texlive-latex-base pandoc texlive-fonts-recommended calibre
sudo apt install latexmk pip3
python3 -m pip install sphinx --user
make
```
## TODO
* grouper les assets dans ce dépot dans src/img et non les mettre en hotlink.
* Table Of Content sur la version HTML.
* afficher les formules mathématiques en syntaxe laTex.
* compléter les chapitres
* chap 1 Abstract
* chap 2 Proof-of-Work mining : a power race
* chap 3 Spam countermeasures (TODO)
* traduire en Français les chapitres
### Références
......
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 6e10d8e2c38b36a46552ef0d7e72044a
tags: 645f666f9bcd5a90fca523b33c5a78b7
File added
File added
File added
File added
File added
File added
File added
File added
File added
File added
build/_images/degrees_en.jpg

13.9 KiB

build/_images/impact_sig_period.png

66.5 KiB

build/_images/wot-moy.png

46.1 KiB

build/_images/wot-sybil.jpg

21.6 KiB

.. Duniter technical description documentation master file, created by
sphinx-quickstart on Sat Jun 20 12:05:38 2020.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Duniter technical description
=============================
.. toctree::
:maxdepth: 2
:caption: Contents:
This diff is collapsed.
.. Duniter: A libre currency blockchain generator.
.. ===============================================
Abstract
--------
Many currency principles involve non-equal rights to monetary creation
between humans. We propose a monetary creation based on the Relative
Theory of Money, which guarantee equal monetary creation for each
willing human. This type of currency can be centralised, however, this
could lead to censorship and arbitrary choices of the central
institution. Thus, strongly inspired by Bitcoin example, we want the
currency to be as decentralised as possible, in the transaction network
as in the human identification process. We use a Web of Trust between
living humans for identification. This web of trust allows us to impose
personalised difficulty for transaction validation, keeping the
calculation accessible to low-end hardware and allowing all competent
members to secure the currency.
Introduction
------------
Duniter is a software to create and manage “libre currencies”. Libre
currency is a concept defined by S.Laborde in the Relative Theory of
Money (RTM) that was published in 2010. This theory demonstrates the
possibility of an invariant monetary unit : the Universal Dividend.
Doing so, the RTM answers the question :
How should a currency be created to match the principle of equality
between all humans, now and between generations ?
The results of this demonstration implies a monetary creation :
- on a regular basis
- for each human being
- which amount has to be reassessed on fixed intervals according to a
fixed formula.
Thus, Duniter project will associate a human to a digital identity. It
will use a Web of Trust with specific rules. As the number of members
may evolve, the Universal Dividend has to be created according to the
formula :
.. math:: UD(t+1) = UD(t) + c^2 \times {M(t) \over N(t)}
Duniter is based on a decentralized Blockchain. This technical choice
allows irreversibility of transaction and uncensorability of trades and
identities. While inspired by Bitcoin, Duniter uses a Web of Trust and
the Proof of Work to secure the computation network, thus making
obsolete the power race model used in Bitcoin.
The first currency created through Duniter is Ğ1, pronounced “June”. It
was created on the 8th. March 2017. This whitepaper uses Ğ1 parameters
as examples ; however, one can create another libre currency with custom
parameters while still using Duniter software.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment