All Projects → ripple → Xrpl Dev Portal

ripple / Xrpl Dev Portal

Licence: other
XRP Ledger developer portal with documentation and examples

Programming Languages

javascript
184084 projects - #8 most used programming language

Projects that are alternatives of or similar to Xrpl Dev Portal

xrpl-dev-portal
Source code for xrpl.org including developer documentation
Stars: ✭ 330 (+66.67%)
Mutual labels:  ripple, consensus
Kubernetes Icons
[obsolete] Set of icons for Kubernetes diagrams, has been merged into official k8s repo!!
Stars: ✭ 194 (-2.02%)
Mutual labels:  documentation
Gatsby Starter Rocket Docs
The documentation starter you were looking for (ready for Gatsby v3) ⚡️
Stars: ✭ 182 (-8.08%)
Mutual labels:  documentation
Tui.editor
🍞📝 Markdown WYSIWYG Editor. GFM Standard + Chart & UML Extensible.
Stars: ✭ 14,016 (+6978.79%)
Mutual labels:  documentation
Vsphere Automation Sdk Rest
REST (Postman and JavaScript) samples and API reference documentation for vSphere using the VMware REST API
Stars: ✭ 182 (-8.08%)
Mutual labels:  documentation
Docsearch Scraper
DocSearch - Scraper
Stars: ✭ 188 (-5.05%)
Mutual labels:  documentation
Docker Bookstack
A Docker container for the BookStack documentation wiki
Stars: ✭ 180 (-9.09%)
Mutual labels:  documentation
Book
文言陰符 An Introduction to Programming in Wenyan Language
Stars: ✭ 194 (-2.02%)
Mutual labels:  documentation
Sofa Jraft
A production-grade java implementation of RAFT consensus algorithm.
Stars: ✭ 2,618 (+1222.22%)
Mutual labels:  consensus
Wsl Guide
The Hitchhiker's Guide to Bash on Ubuntu on Windows!
Stars: ✭ 186 (-6.06%)
Mutual labels:  documentation
Re Whatsapp
Reverse engineering WhatsApp. Documentation and protocols.
Stars: ✭ 184 (-7.07%)
Mutual labels:  documentation
Docs Chinese
Fastify 中文文档
Stars: ✭ 183 (-7.58%)
Mutual labels:  documentation
Bismuth
[Migrated] The first Python blockchain protocol and platform
Stars: ✭ 186 (-6.06%)
Mutual labels:  consensus
Kau
An extensive collection of Kotlin Android Utils
Stars: ✭ 182 (-8.08%)
Mutual labels:  ripple
Swagger Toolbox
💡 Swagger schema model (in yaml, json) generator from json data
Stars: ✭ 194 (-2.02%)
Mutual labels:  documentation
Cirrus Ci Docs
Documentation for Cirrus CI 📚
Stars: ✭ 180 (-9.09%)
Mutual labels:  documentation
Play2 Hands On
Play2 + Slick / ScalikeJDBCを使ってWebアプリケーションを作成するハンズオンです。
Stars: ✭ 183 (-7.58%)
Mutual labels:  documentation
Chinese Programmer Wrong Pronunciation
中国程序员容易发音错误的单词
Stars: ✭ 14,766 (+7357.58%)
Mutual labels:  documentation
Codetogo.io
🚀 JavaScript code to go - Find updated snippets for common JavaScript use cases
Stars: ✭ 198 (+0%)
Mutual labels:  documentation
Docs
System76 documentation site
Stars: ✭ 193 (-2.53%)
Mutual labels:  documentation

XRPL Dev Portal

The XRP Ledger Dev Portal is the authoritative source for XRP Ledger documentation, including the rippled server, RippleAPI, the Ripple Data API, and other open-source XRP Ledger software.

To build the site locally:

  1. Install Dactyl and lxml:

     sudo pip3 install dactyl lxml
    
  2. Clone the repo and change into its directory:

     git clone [email protected]:ripple/xrpl-dev-portal.git && cd xrpl-dev-portal
    
  3. Build the site to the out/ directory:

     dactyl_build -t en
    

If you get an error, try upgrading Dactyl before building:

  sudo pip3 install --upgrade dactyl

For more details, see the contribution guidelines (EN) (日本語) and the contributor Code of Conduct (EN) (日本語).

Domain Verification Checker

If you make changes to the Domain Verification Checker tool and edit the domain-verifier-checker.js file, you will need to do the following:

  1. Install webpack and required libraries via npm:

     npm install webpack webpack-cli --save-dev
     npm install ripple-binary-codec ripple-address-codec ripple-keypairs
    
  2. From the project root directory (this step may be different depending on how you installed webpack)

     cd assets/js
     webpack-cli domain-verifier-checker.js --optimize-minimize -o domain-verifier-bundle.js
    
  3. Build the site:

     cd ../..
     dactyl_build -t en
    

Locale Strings

The templates can contain strings that are intended to be translated. These strings are marked off with {% trans %} and {% endtrans %} tags. You can't have any Jinja block control structures in these tags, but you can have some HTML markup and some basic Jinja variable-printing logic. See the Jinja Documentation for what's possible.

If you make changes to these strings, or want to add or update a translation, you'll need to do some extra steps to manage the locale files. These steps require the Babel (pybabel) commandline utility. To install it:

sudo pip3 install Babel

You don't need Babel to build and view the site otherwise.

Add a language

This repo has English (en) and Japanese (ja) locales set up already. To add a language (do this from the repo top dir):

$ pybabel init -l ja -i ./locale/messages.pot -o ./locale/ja/LC_MESSAGES/messages.po

Instead of ja (in two places in the above line!!) use the locale code for the language you plan to add. There's no exhaustive, definitive list, but this list of locale codes is a good starting place.

This creates a "PO" file (./locale/ja/LC_MESSAGES/messages.po) with empty translations for the strings in the templates, based on the "PO Template" file (./locale/messages.pot).

To actually add translations for strings, you need to edit the new PO file for this translation. You can edit the PO file file with a text editor, or use a more advanced tool if you're a pro. Don't change the msgid values, do change the msgstr values.

When you're done translating, compile the PO files.

Update Strings

If there are new or updated {% trans %} tags in the templates, first use this command to extract them:

$ pybabel extract -F ./locale/babel.cfg -o ./locale/messages.pot ./

Then, update every language's .po files with the list of strings, as follows:

$ pybabel update -l ja -d ./locale/ -i ./locale/messages.pot

The above example is for Japanese (-l ja). Repeat for each language code.

Now edit the PO files (for example, locale/ja/LC_MESSAGES/messages.po) to add translations for each newly-added string. Again, repeat for each language.

If you only want to change an existing translation for a given string that hasn't changed in the original, you can skip straight to editing the PO files without running any update or extract commands.

After you've edited all the PO files, be sure to compile them.

Compile Strings

Whether you added a language, added new strings, or tweaked an existing translation, you must compile the PO files (text) to MO files (binary) to get Dactyl to use them.

To compile all PO files:

$ pybabel compile -f -d ./locale/

If you added a new language for the first time, you need to make sure its target definition (in the dactyl-config.yml file) has the MO file in the locale_file field.

After that, next time you build the site using Dactyl it should pull the updated translations!

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].