Skip to content
GitLab
Switch branch/tag
Find file Normal viewHistoryPermalink
rtl.html 1.65 KB
Newer Older
Mark Otto's avatar
Break up docs into includes  
Mark Otto committed
1
2
3
4
5
6
7
8
9
10 
<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 %}
Chris Rebert's avatar
emphasize that bootstrap-rtl.css & bootstrap.css should not be used together    
Chris Rebert committed
11 
  <p>Then, include the right-to-left CSS file <strong>instead of</strong> the default Bootstrap CSS:</p>
Mark Otto's avatar
Break up docs into includes  
Mark Otto committed
12
13
14
15
16
17 
{% 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>
Chris Rebert's avatar
emphasize that bootstrap-rtl.css & bootstrap.css should not be used together    
Chris Rebert committed
18
19
20
21
22 
  <div class="bs-callout bs-callout-danger">
    <h4>Do not use in combination with <code>bootstrap.css</code></h4>
    <p><code>bootstrap-rtl.css</code> must not be used together with <code>bootstrap.css</code>. Use either one or the other, but not both. <code>bootstrap-rtl.css</code> includes all of Bootstrap's styles, including those not affected by writing direction.</p>
  </div>
Mark Otto's avatar
Break up docs into includes  
Mark Otto committed
23
24
25 
  <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>