web-dev-qa-db-fra.com

Compiler Twitter bootstrap 3 docs (Comment)?

J'essaye de compiler bootstrap 3. J'ai le repo cloné sur mon local. Je lance make dans le répertoire bootstrap.

aaas-iMac:bootstrap aaa$ make



Building Bootstrap...
--------------------------------------------------
Running JSHint on JavaScript...             ✔ Done
Compiling LESS with Recess...               ✔ Done
Prepping documentation assets...            ✔ Done
Compiling and minifying JavaScript...       ✔ Done
--------------------------------------------------
Success!

Thanks for using Bootstrap,
<3 @mdo and @fat

aaas-iMac:bootstrap aaa$

Je ne vois nulle part la documentation compilée?

twitter-bootstrapmakefiletwitter-bootstrap-3
21
Harry

Les documents de Bootstrap 3.0 sont construits avec Jekyll . Pour afficher les documents localement, vous devez installer Jekyll pour exécuter un serveur local.

11
Kisuka

Pour installer Jekyll et construire: (Remarque pour Windows, voir: https://stackoverflow.com/a/16853614/1596547 )

  1. installer rubygems (Sudo apt-get install rubygems)
  2. (Sudo) gem install jekyll
  3. allez dans le répertoire ./docs de votre installation bootstrap (voir aussi: Explorer et installer Twitter Bootstrap 3 )
  4. lancez jekyll --server à partir de votre répertoire d'amorçage
  5. visitez http://localhost:9001/ http://localhost:9001/docs.html dans votre navigateur

NB: le port par défaut pour WEBrick sera 9001. Si ce port n'est pas disponible, un autre port sera utilisé: WARN TCPServer Error: Address already in use - bind(2) INFO WEBrick::HTTPServer#start: pid=30728 port=4000

Lorsque vous visitez http://localhost:9001/, vous trouverez un écran d’accueil. Le bouton "Afficher les documents" relie à/docs/lorsque les documents sont sur docs.html Voir ci-dessous:

Twitter's Bootstrap 3.0.0 Docs

Maintenant (10 juillet 2013), les liens de la barre de navigation semblent cassés (.html manquant), utilisez donc http://localhost:9001/javascript.html au lieu de http://localhost:9001/javascript. Voir aussi: https://github.com/Twitter/bootstrap/pull/8443

Utilisation de git (jekyll déjà installé):

git clone --branch 3.0.0-wip git://github.com/Twitter/bootstrap.git
cd bootstrap
jekyll --server

visitez http://localhost:9001/ ou http://localhost:4000/

UPDATE@ lee-whitney suggère d'utiliser jekyll serve au lieu de jekyll --server. La commande jekyll serve crée un répertoire avec les fichiers HTML des documents. Vous pouvez servir ces fichiers sur un serveur Web (local). jekyll serve ne démarre pas un serveur (jekyll). Je teste ces commandes sur Linux (Ubuntu 12.04LTS) avec Jekyll 0.12.1

14
Bass Jobsen

Sous Windows (parfaitement testé par moi pas sûr de Linux): 

Étape 1: Téléchargez Bootstrap3: github.com/Twitter/bootstrap/archive/3.0.0-wip.Zip 
Étape 2: Téléchargez Ruby: Cliquez ici
Étape 3: Téléchargez le kit de développement: Cliquez ici et extrayez-le dans un répertoire.
Étape 4: Accédez au répertoire devkit via le terminal Ruby et exécutez les commandes suivantes

Ruby dk.rb init
Ruby dk.rb install
gem install jekyll --version '= 0.11.0'

L’étape de la version est très importante car je n’étais pas capable de compiler la documentation dans la dernière version de jekyll, je suis donc passé à l’ancienne version.

Étape 5: accédez au répertoire racine de votre répertoire d'amorçage
Step6: lancer jekyll --server 
Step7: visitez localhost: 9001/ou localhost: 4000/dans votre navigateur (l'un d'entre eux fonctionnera sûrement)

5
Abhishek Goel

J'ai essayé la méthode d'Abhishek et cela a fonctionné. Mais pas complètement. J'ai encore des erreurs de fluide.

J'ai donc beaucoup fouillé et trouvé une solution. Compiler Bootstrap 3 est un peu plus embêtant que 2.3.2

Procédez comme suit pour compiler et le faire fonctionner.

  1. Obtenir Bootstrap 3 master Zip

  2. Obtenez Ruby 1.9.3

  3. Obtenir DevKit

  4. Installez Python 2.7 et mettez à jour la variable d'environnement PATH avec le répertoire python

  5. Obtenez Jekyll 1.x comme indiqué sur la page GitHUb de Bootstrap. 

    Accédez au répertoire devkit via le terminal Ruby et exécutez les commandes suivantes.

    Ruby dk.rb init
    Ruby dk.rb installer
    gem installer jekyll

  6. Désinstallez pygments 0.5.2 et installez pygments 0.5.0 

    gem désinstaller pygments.rb --version "= 0.5.2"
    gem installer pygments.rb --version "= 0.5.0"

  7. Accédez au répertoire racine de la source d’amorçage extraite de votre terminal et exécutez la procédure suivante.

    chcp 65001
    jekyll servir

Maintenant, accédez à localhost: 9001 et vous verrez les documents hébergés localement.

NOTE: Une fois compilé, vous pouvez accéder à ces pages sans avoir à exécuter la commande jekyll serve à chaque fois. Ouvrez simplement les pages HTML comme vous le feriez avec n'importe quelle page Web enregistrée localement.

Aussi, n'hésitez pas à supprimer les fichiers DevKit extraits car vous ne les utiliserez plus pour afficher les documents.

3
Thoshi B

Voici la solution complète

Pour installer Jekyll, Rouge et construire:

si vous n'avez pas installé Ruby - http://jekyll-windows.juthilo.com/2-jekyll-gem/

  1. de comand promt, cd dans votre dossier de démarrage
  2. exécuter npm install - si vous rencontrez des problèmes, faites un npm update
  3. si jekyll n'a pas été installé, lancez gem install jekyll
  4. puis lancez gem install rouge
  5. lancez jekyll server à partir de votre dossier d'amorçage
  6. visiter http: // localhost: 9001/
1
Charl Kruger

Voici les documents compressés, inutile de lire. Docs Bootstrap 3 téléchargeables intégralement.

http://web3canvas.com/item/bootstrap-3-docs/

Prendre plaisir!

1
Alejandro Casanova

Update: For Bootstrap version 3.3.4

Pour exécuter les docs Twitter Bootstrap(v3.3.4) localement, j’ai suivi les étapes suivantes et j’espère que cela pourra aider d’autres.

Pas:

  • gem install jekyll (doit avoir Ruby, Rubygems installé)

  • git clone --branch gh-pages git://github.com/Twitter/bootstrap.git

    (maintenant gh-pages branche contient tout ce qui concerne la documentation)

  • cd bootstrap
  • jekyll serve
  • Visitez http://127.0.0.1:4000/ URL du serveur par défaut
0
ram