diff --git a/CNAME b/CNAME
deleted file mode 100644
index 971b74dd..00000000
--- a/CNAME
+++ /dev/null
@@ -1 +0,0 @@
-bitcoin.org
diff --git a/COPYING b/COPYING
index 43bd8c66..156cd09d 100644
--- a/COPYING
+++ b/COPYING
@@ -1,5 +1,6 @@
Various picture files inside the folders listed above are subjected to copyright restrictions. The use of these materials is not permitted unless otherwise specified by their copyright owner.
+img/brand
img/clients
img/faq
img/innovation
diff --git a/README.md b/README.md
index 4ba6869f..554ed82f 100644
--- a/README.md
+++ b/README.md
@@ -1,36 +1,78 @@
-# Usage
+## How to participate
-**Easy preview**: Simple changes in the texts can be previewed live on bitcoin.org with any recent browser. You only need to click anywhere on the page and hold your mouse button for one second. You'll then be able to edit the page just like a document. Changes will be lost as soon as the page is refreshed.
+You can report any problem or help to improve bitcoin.org by opening an issue or a [pull request](#working-with-github) on [GitHub](https://github.com/bitcoin/bitcoin.org). You can also help [translating bitcoin.org](#translation) on [Transifex](https://www.transifex.com/projects/p/bitcoinorg/).
-**Real preview**: Install dependencies, edit the files, run jekyll (or "jekyll build" on older setups), and copy the output files from _site/ at the root of your web server. If you have no web server, run jekyll --server (or "jekyll serve" on older setups). This server requires you to add a trailing ".html" by hand in your browser window.
+### Working with GitHub
-## Requirements
+GitHub allows you to make changes to a project using git, and later submit them in a "pull request" so they can be reviewed and discussed. Many online how-tos exist so you can learn git, [here's a good one](https://www.atlassian.com/git/tutorial/git-basics).
+
+In order to use GitHub, you need to [sign up](http://github.com/signup) and [set up git](https://help.github.com/articles/set-up-git). You will also need to click the **Fork** button on the bitcoin.org [GitHub page](https://github.com/bitcoin/bitcoin.org) and clone your GitHub repository into a local directory using the following command lines:
+
+```
+git clone (url provided by GitHub on your fork's page) bitcoin.org
+cd bitcoin.org
+git remote add upstream https://github.com/bitcoin/bitcoin.org.git
+```
+
+**How to send a pull request**
+
+1. Checkout to your master branch. `git checkout master`
+2. Create a new branch from the master branch. `git checkout -b (any name)`
+3. Edit files and [preview](#previewing) the result.
+4. Track changes in files. `git add -A`
+5. Commit your changes. `git commit -m '(short description for your change)'`
+6. Push your branch on your GitHub repository. `git push origin (name of your branch)`
+7. Click on your branch on GitHub and click the **Compare / pull request** button to send a pull request.
+
+When submitting a pull request, please take required time to discuss your changes and adapt your work. It is generally a good practice to split unrelated changes into separate branchs and pull requests.
+
+**How to make additional changes in a pull request**
+
+You simply need to push additionnal commits on the appropriate branch of your GitHub repository. That's basically the same steps as above, except you don't need to re-create the branch and the pull request.
+
+**How to reset and update your master branch with latest upstream changes**
+
+1. Fetch upstream changes. `git fetch upstream`
+2. Checkout to your master branch. `git checkout master`
+3. Replace your master branch by the upstream master branch. `git reset --hard upstream/master`
+4. Replace your master branch on GitHub. `git push origin master -f`
+
+### Previewing
+
+**Easy preview**: Simple text changes can be previewed live on bitcoin.org. You only need to click anywhere on the page and hold your mouse button for one second. You'll then be able to edit the page just like a document. Changes will be lost as soon as the page is refreshed.
+
+**Real preview**: Install [dependencies](#requirements), run jekyll (or "jekyll build" on older setups), and copy the output files from _site/ to the root of your web server. If you have no web server, run jekyll --server (or "jekyll serve" on older setups). This server requires you to add a trailing ".html" by hand in your browser address bar.
+
+### Requirements
Installing dependencies on Ubuntu 12.10
- sudo apt-get install jekyll node-less ruby1.9.1-dev
+ sudo apt-get install jekyll node-less ruby1.9.1-dev libicu-dev
sudo gem install ffi-icu
Installing dependencies on older Ubuntu and Debian distributions
- sudo apt-get install rubygems ruby1.9.1-dev build-essential
+ sudo apt-get install rubygems ruby1.9.1-dev build-essential libicu-dev
sudo gem install jekyll json less therubyracer ffi-icu
## Translation
### How to translate
-* Translations can be done on Transifex https://www.transifex.com/projects/p/bitcoinorg/
+You can join a translation team on [Transifex](https://www.transifex.com/projects/p/bitcoinorg/) and start translating or improving existing translations. Latest live previews and communications can be found on [this thread](https://bitcointalk.org/index.php?topic=349633.0).
+
* You must be a native speaker for the language you choose to translate.
-* At least one other reviewer is required.
-* Changing the meaning of any statement should be avoided. In doubt, you can open a discussion on Transifex.
-* Sentences and popular expressions should be adapted so that they sound native in your language.
+* Please be careful to preserve the original meaning of each text.
+* Sentences and popular expressions should sound native in your language.
+* Translations need to be reviewed by a reviewer or coordinator before publication.
+* Once reviewed, translations can be [submitted](#import-translations) in a pull request on GitHub.
+* **In doubt, please open a discussion on Transifex with coordinators. That'll be much appreciated.**
### Import translations
-**Update translations**: You can overwrite each language files in _translations by their updated version from Transifex. You should make sure that each .html files (in _layouts, _templates) don't serve outdated content for those languages. You should also make sure that no url has been changed by translators. If one page has been replaced or moved, a redirection can be added in _config.yml.
+**Update translations**: You can update the relevant language file in \_translations/ and from the root of the git repository run ./\_contrib/updatetx.rb to update layouts and templates for this language. You should also make sure that no url has been changed by translators. If any page needs to be moved, please add [redirections](#redirections).
-**Add a new language**: You can put the language file from Transifex in _translations and add the language in _config.yml in the right display order for the language bar. Make sure to review all pages and check all links.
+**Add a new language**: You can put the language file from Transifex in \_translations and add the language in \_config.yml in the right display order for the language bar. Make sure to review all pages and check all links.
### Update english strings
@@ -54,7 +96,41 @@ Any change in the english texts can be done through a pull request on GitHub. If
(update en.yml)
tx push -s -t -f --skip --no-interactive
-## Advanced Usage
+## Posts
+
+### Events
+
+Events should be placed in `_events/YYYY-MM-DD-SHORTTITLE.md` and adhere to this format:
+
+```
+---
+title: "2014 Texas Bitcoin Conference"
+venue: "Circuit of the Americas™ - Technology and Conference Center"
+address: "9201 Circuit of the Americas Blvd"
+city: "Austin, TX"
+country: "United States"
+link: "http://texasbitcoinconference.com/"
+---
+```
+
+### Release Notes
+
+Release notes should be placed in `_releases/YYYY-MM-DD-VERSION.md` and adhere to this format:
+
+```
+---
+title: Bitcoin Core version 0.9.0 released
+src: http://sourceforge.net/p/bitcoin/mailman/message/32119564/
+---
+
+Bitcoin Core v0.9.0 is now available for download at
+
{% translate walletbitcoinqt %}
{% translate walletdownload %}
{% translate walletmultibit %}
- +{% translate wallethive %}
- +{% translate walletarmory %}
- +{% translate walletelectrum %}
- +{% translate walletbitcoinqt %}
{% translate walletdownload %}
{% translate walletmultibit %}
- +{% translate wallethive %}
- +{% translate walletarmory %}
- + @@ -292,7 +292,7 @@ id: choose-your-wallet{% translate walletelectrum %}
- + @@ -408,7 +408,7 @@ id: choose-your-wallet{% translate walletblockchaininfomob %}
- +{% translate walletblockchaininfo %}
- + @@ -497,7 +497,7 @@ id: choose-your-wallet{% translate walletcoinbase %}
- + @@ -510,7 +510,7 @@ id: choose-your-wallet{% translate walletcoinkite %}
- + diff --git a/_templates/community.html b/_templates/community.html index 85f34e62..ebfa043a 100644 --- a/_templates/community.html +++ b/_templates/community.html @@ -9,14 +9,16 @@ id: community{% translate bitcointalk %}
- - + +{% translate linkgoogle %}
{% translate facebook %}
diff --git a/_templates/development.html b/_templates/development.html index 46afdbf4..6442398d 100755 --- a/_templates/development.html +++ b/_templates/development.html @@ -49,12 +49,12 @@ id: development{% translate downloados %}
{% case page.lang %}{% when 'ar' or 'fa' or 'id' or 'it' or 'nl' or 'pl' or 'tr' or 'zh_CN' or 'zh_TW' %}{% translate downloadsig download en %}{% else %}{% translate downloadsig %}{% endcase %}
+ Get the source code
{% translate versionhistory %}
{% translate notelicense %}
{% translate islegaltxt1 %}
{% translate islegaltxt2 %}
{% translate nodetxt %}
{% case page.lang %} -{% when 'ar' or 'bg' or 'de' or 'fa' or 'id' or 'it' or 'nl' or 'pl' or 'tr' or 'zh_CN' or 'zh_TW' %} +{% when 'ar' or 'bg' or 'fa' or 'id' or 'it' or 'nl' or 'pl' or 'tr' or 'zh_CN' or 'zh_TW' %} {% else %}{% translate miningtxt %}
@@ -23,7 +23,7 @@ id: support-bitcoin {% case page.lang %} {% when 'ar' %} {% else %} -Bitcoin-Qt - Bitcoin.org - Bitcoin Wiki - Bitcoin Wallet (Android) - MultiBit - Electrum - Hive
+Bitcoin Core - Bitcoin.org - Bitcoin Wiki - Bitcoin Wallet (Android) - MultiBit - Electrum - Hive
{% endcase %}{% translate foundationtxt %}
{% else %}