mirror of
https://github.com/seigler/dash-docs
synced 2025-07-28 02:06:13 +00:00
No description
Similar to how we would not say cars are volatile if large price swings for cars happen often, we shouldn't say Bitcoin is volatile because its price is volatile. It's important to distinguish between the underlying technology that is Bitcoin, and the price of the tradable currency unit within this network. The currency units may fluctuate often and greatly in price, but the Bitcoin technology itself is not volatile because of this. Additionally, I've used the lowercase "bitcoin" when talking about the currency *unit* rather than the "Bitcoin" technology/network. |
||
---|---|---|
_contrib | ||
_layouts | ||
_less | ||
_plugins | ||
_posts | ||
en | ||
font | ||
fr | ||
img | ||
js | ||
.gitignore | ||
_config.yml | ||
about.html | ||
andreas_schildbach.asc | ||
bitcoin.pdf | ||
chainfork.html | ||
clients.html | ||
CNAME | ||
critfix.html | ||
dos.html | ||
favicon.ico | ||
favicon.png | ||
feb20.html | ||
gavinandresen.asc | ||
gmaxwell.asc | ||
index.html | ||
jgarzik-exmulti.asc | ||
laanwj.asc | ||
may15.html | ||
news.html | ||
pieterwuille.asc | ||
README.md | ||
robots.txt | ||
schneider.asc | ||
sitemap.xml |
Requirements
Installing dependencies
sudo apt-get install rubygems ruby1.9.1-dev build-essential
sudo gem install jekyll aquarium json less therubyracer
Usage
- update DOWNLOAD_VERSION in _config.yml
- run ./_contrib/updatesitemap if you changed a page
- run jekyll
- output will be in _site/
Translation
- Find the two letter ISO 639-1 code for your language (fr, en, jp)
- Run ./_contrib/translate (language code) (language name)
- Make sure that languages are listed in alphabetical order in _config.yml
- Rename html files in (lang)/ according to your language. And update links in _layouts/base-(lang).html and (lang)/*.html to reflect your changes.
- Translate all .html and images files in (lang)/ and _layouts/base-(lang).html
- A tips for translators, you can preview your work in a simple Google chrome browser with no HTTP server. Just go to the existing english page, open the javascript console with CTRL + SHIFT + J and use the following command to make the page editable : document.body.contentEditable=true
Advanced Usage
Alerts
You can easily put a global alert on the website by changing the ALERT and ALERT_CLASS variables in _config.yml. And you can also set an alert specific to a language by appending the language code to the ALERT.
Example:
ALERT_CLASS: error
ALERT: <strong>Security alert:</strong> Please upgrade to 0.3.25 as soon as possible!
ALERT_fr: <strong>Alerte de sécurité:</strong> Mettez Bitcoin à jour vers la version 0.3.25 sans délais!
will produce an english red alert box for all languages, and a translated red alert box for french language. Possible classes are: error (red), info (blue), success (green) and warning (yellow)
Release Notes
Release notes should be placed in _posts/releases/YEAR-MONTH-DAY-SHORTTITLE.md
and adhere to this format:
---
layout: post
title: Bitcoin version 0.3.24 released
src: http://sourceforge.net/mailarchive/message.php?msg_id=27771039
category: releases
---
Bitcoin v0.3.24 is now available for download at
<https://sourceforge.net/projects/bitcoin/files/Bitcoin/bitcoin-0.3.24/>
...
SHORTTITLE
is used to construct the URL. Something likev0.3.24
will be finelayout: post
important for Jekylltitle: ...
will be used as the titlesrc: ...
(optional) link to full annoucementcategory: ...
category of post **releases
**events
Aliases for contributors
Aliases for contributors are defined in _config.yml
.
aliases:
s_nakamoto: Satoshi Nakamoto
--author=Satoshi Nakamoto: Satoshi Nakamoto
gavinandresen: Gavin Andresen
Requirements
These ruby gems are required to build the website:
- jekyll
- aquarium
- json
- less
- therubyracer