From 559b90f944fe9cfd463c1be3f89cf5d7cf7f8cb4 Mon Sep 17 00:00:00 2001
From: Mark Otto <otto@github.com>
Date: Mon, 3 Mar 2014 23:50:04 -0800
Subject: [PATCH] Rename RTL files and add some basic docs
---
Gruntfile.js | 10 ++++----
.../{bootstrap.rtl.css => bootstrap-rtl.css} | 0
...trap.rtl.min.css => bootstrap-rtl.min.css} | 0
docs/_includes/nav-css.html | 8 ++++++
docs/css.html | 25 +++++++++++++++++++
...trap.rtl.min.css => bootstrap-rtl.min.css} | 0
6 files changed, 38 insertions(+), 5 deletions(-)
rename dist/css/{bootstrap.rtl.css => bootstrap-rtl.css} (100%)
rename dist/css/{bootstrap.rtl.min.css => bootstrap-rtl.min.css} (100%)
rename docs/dist/css/{bootstrap.rtl.min.css => bootstrap-rtl.min.css} (100%)
diff --git a/Gruntfile.js b/Gruntfile.js
index e7c489f017..7257791463 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -192,7 +192,7 @@ module.exports = function (grunt) {
},
files: {
'dist/css/<%= pkg.name %>.min.css': 'dist/css/<%= pkg.name %>.css',
- 'dist/css/<%= pkg.name %>.rtl.min.css': 'dist/css/<%= pkg.name %>.rtl.css',
+ 'dist/css/<%= pkg.name %>-rtl.min.css': 'dist/css/<%= pkg.name %>-rtl.css',
'dist/css/<%= pkg.name %>-theme.min.css': 'dist/css/<%= pkg.name %>-theme.css'
}
}
@@ -201,7 +201,7 @@ module.exports = function (grunt) {
cssFlip: {
rtl: {
files: {
- 'dist/css/<%= pkg.name %>.rtl.css': 'dist/css/<%= pkg.name %>.css'
+ 'dist/css/<%= pkg.name %>-rtl.css': 'dist/css/<%= pkg.name %>.css'
}
}
},
@@ -231,9 +231,9 @@ module.exports = function (grunt) {
files: {
src: [
'dist/css/<%= pkg.name %>.css',
- 'dist/css/<%= pkg.name %>.rtl.css',
+ 'dist/css/<%= pkg.name %>-rtl.css',
'dist/css/<%= pkg.name %>.min.css',
- 'dist/css/<%= pkg.name %>.rtl.min.css',
+ 'dist/css/<%= pkg.name %>-rtl.min.css',
'dist/css/<%= pkg.name %>-theme.css',
'dist/css/<%= pkg.name %>-theme.min.css'
]
@@ -248,7 +248,7 @@ module.exports = function (grunt) {
dist: {
files: {
'dist/css/<%= pkg.name %>.css': 'dist/css/<%= pkg.name %>.css',
- 'dist/css/<%= pkg.name %>.rtl.css': 'dist/css/<%= pkg.name %>.rtl.css',
+ 'dist/css/<%= pkg.name %>-rtl.css': 'dist/css/<%= pkg.name %>-rtl.css',
'dist/css/<%= pkg.name %>-theme.css': 'dist/css/<%= pkg.name %>-theme.css'
}
},
diff --git a/dist/css/bootstrap.rtl.css b/dist/css/bootstrap-rtl.css
similarity index 100%
rename from dist/css/bootstrap.rtl.css
rename to dist/css/bootstrap-rtl.css
diff --git a/dist/css/bootstrap.rtl.min.css b/dist/css/bootstrap-rtl.min.css
similarity index 100%
rename from dist/css/bootstrap.rtl.min.css
rename to dist/css/bootstrap-rtl.min.css
diff --git a/docs/_includes/nav-css.html b/docs/_includes/nav-css.html
index 15025da0cf..6da0b11dd7 100644
--- a/docs/_includes/nav-css.html
+++ b/docs/_includes/nav-css.html
@@ -128,3 +128,11 @@
<li><a href="#sass-installation">Rails install</a></li>
</ul>
</li>
+<li>
+ <a href="#rtl">RTL version</a>
+ <ul class="nav">
+ <li><a href="#rtl-overview">Overview</a></li>
+ <li><a href="#rtl-how-to">How to use</a></li>
+ <li><a href="#rtl-css-flip">CSS Flip</a></li>
+ </ul>
+</li>
diff --git a/docs/css.html b/docs/css.html
index e1af6985e0..8baf8f42dc 100644
--- a/docs/css.html
+++ b/docs/css.html
@@ -3345,3 +3345,28 @@ a {
<a class="btn btn-lg btn-outline" href="{{ site.sass_repo }}">Bootstrap for Sass</a>
</p>
</div>
+
+
+
+<!-- RTL
+================================================== -->
+<div class="bs-docs-section">
+ <h1 id="rtl" class="page-header">RTL</h1>
+ <p class="lead">As of Bootstrap 3.2, a right-to-left version of Bootstrap ships as part of the repository. It's powered by Twitter's <a href="https://github.com/twitter/css-flip">CSS Flip project</a> and is generated via our Gruntfile.</p>
+
+ <h2 id="rtl-how-to">How to use</h2>
+ <p>Bootstrap is by default a left-to-right project. For right-to-left projects, you'll need to set your language and replace the default Bootstrap CSS with an RTL version. First, set your language and text direction:</p>
+{% highlight html %}
+<!-- Example: Arabic language with direction set to RTL -->
+<html lang="ar" dir="rtl">
+{% endhighlight %}
+ <p>Then, include the right-to-left CSS file in place of the default Bootstrap CSS:</p>
+{% highlight html %}
+<!-- Bootstrap RTL -->
+<link rel="stylesheet" href="bootstrap-rtl.css">
+{% endhighlight %}
+ <p>Alternatively, you may use the minified RTL file, <code>bootstrap-rtl.min.css</code>.</p>
+
+ <h2 id="rtl-css-flip">CSS Flip</h2>
+ <p><a href="https://github.com/twitter/css-flip">CSS Flip</a> is a project for converting left-to-right CSS files into right-to-left CSS files. We use it in our Gruntfile to automate the generation of Bootstrap's RTL CSS files.</p>
+</div>
diff --git a/docs/dist/css/bootstrap.rtl.min.css b/docs/dist/css/bootstrap-rtl.min.css
similarity index 100%
rename from docs/dist/css/bootstrap.rtl.min.css
rename to docs/dist/css/bootstrap-rtl.min.css
--
GitLab