Giters

tkrotoff / osteo15

Home Page:https://osteo15.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Osteo15 blog

osteo15.com

xcode-select --install # Installation de Xcode command line developer tools

# 'ruby/config.h' file not found
# https://github.com/CocoaPods/CocoaPods/issues/10286#issuecomment-1361362989

bundle install
bundle update

bundle exec jekyll serve --host 0.0.0.0 --port 4000
open http://localhost:4000

bundle exec rake -T # Liste des tasks Rake
bundle exec rake clean # Supprime les fichiers générés
bundle exec rake build # Build sans minification (=dev)
bundle exec rake checkstyle # Vérifie diverses règles en rapport avec le style
bundle exec rake "build[production]" # Build avec minification du code HTML et CSS (=production)
bundle exec rake deploy # Déploiement sur Amazon S3
brew install vnu
vnu --skip-non-html _site

bundle exec htmlproofer ./_site --check-html --check-favicon --check-opengraph

cd _site && bundle exec validate-website-static --site 'https://osteo15.com' --verbose --markup --not-found && cd ..
bundle exec validate-website --site 'https://osteo15.com' --verbose --markup --not-found

sudo gem install site_validator
site_validator https://osteo15.com site_validator-report.html
open site_validator-report.html

Git hooks:

ln -s -f ../../git-hooks/pre-commit .git/hooks/pre-commit
ln -s -f ../../git-hooks/pre-push .git/hooks/pre-push

Utilisation de post_url

Pour générer un lien vers un post, il faut utiliser la fonction post_url de Jekyll :

{% post_url 2014-08-08-Lombalgie-paracetamol-et-osteopathie %}
voir [l'article sur la lombalgie et le paracétamol]({% post_url 2014-08-08-Lombalgie-paracetamol-et-osteopathie %})

Le problème des caractères spéciaux

Nom des fichiers

Windows interdit les caractères \/:*?"<>|, exemple :

  • KO : 2014-04-18-La-methode-"De-Gasquet"-pour-se-preparer-a-l'accouchement-et-retrouver-la-forme-apres.md
  • OK : 2014-04-18-La-methode-De-Gasquet-pour-se-preparer-a-l'accouchement-et-retrouver-la-forme-apres.md

Le caractère ? est replacé par %3F dans les URLs, ce qui est à éviter :

  • KO : 2014-08-21-Bebe-:-quand-consulter-un-osteopathe-?.md => /2014/08/21/Bebe-:-quand-consulter-un-osteopathe-%3F/
  • OK : 2014-08-21-Bebe-quand-consulter-un-osteopathe.md => /2014/08/21/Bebe-quand-consulter-un-osteopathe/

Jekyll crash si le nom d'un fichier comporte : :

  • KO : 2014-02-10-Jogging-:-le-pied-amortisseur.md
  • OK : 2014-02-10-Jogging-le-pied-amortisseur.md

Liste des caractères valides pour une URL : ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~:/?#[]@!$&'()*+,;=

URLs

Par exemple, les espaces ne sont pas autorisés : HTML href syntax: is it okay to have space in file name?. Il faut utiliser cgi_escape.

Exemple :

<!-- site.address_short = "7 rue de Langeac Paris 15" -->
<a href="https://maps.apple.com/?q={{ site.address_short | cgi_escape }}">{{ site.address_short }}</a>
<!--
  URL générée : "https://maps.apple.com/?q=7+rue+de+Langeac+Paris+15"
  au lieu de : "https://maps.apple.com/?q=7 rue de Langeac Paris 15"
-->

post_url ne fonctionne pas avec des accents, exemple :

<!-- KO -->
[la micronutrition]({% post_url 2014-03-25-Introduction-à-la-micronutrition %})

<!-- OK -->
[la micronutrition]({% post_url 2014-03-25-Introduction-a-la-micronutrition %})

Pareil pour les assets (images et autres fichiers) (problème détecté sous Ubuntu 14.10 x64, Ruby 2.1.0, Jekyll 2.4.0) :

<!-- KO -->
![Schéma déroulement consultation](/assets/2014-08-20/Déroulement consultation.png)

<!-- OK -->
![Schéma déroulement consultation](/assets/2014-08-20/Deroulement-consultation.png)

Formats des images

  • Le format non destructeur PNG (.png) adapté pour les images simples comprenant des aplats de couleurs
  • Le format destructeur JPEG (.jpg) pour la photographie

Figures

{% include figure.html src="/assets/2014-03-15/Le-ventre-notre-deuxieme-cerveau.jpg" caption='Affiche du documentation "Le ventre, notre deuxième cerveau"' href="https://boutique.arte.tv/detail/ventre_notre_deuxieme_cerveau" %}
{% include figure.html src="/assets/2014-04-15/Gel-douche,-peaux-sensibles-s'abstenir.jpg" caption="Affiche du documentation \"Gel douche, peaux sensibles s'abstenir\"" href="https://web.archive.org/web/20161203061420/https://www.france5.fr/emission/gel-douche-peaux-sensibles-sabstenir/diffusion-du-13-04-2014-20h35" %}
<figure>
  <img src="/assets/2014-07-30/Lombalgies-symptomatiques.png" alt="Lombalgies symptomatiques" loading="lazy">
  <figcaption markdown="1">
  Lombalgies symptomatiques [^2]
  </figcaption>
</figure>

Grille HTML

Voir la documentation de Bootstrap : https://getbootstrap.com/docs/3.4/css/#grid

Intégration d'une vidéo

{% include embed-responsive-4by3.html src="https://www.youtube.com/embed/VJo5z11rUYQ" %}

Intégration d'une carte Google Maps

<div class="row">
  <div class="col-md-10">
    <div class="embed-responsive embed-responsive-4by3">
      <iframe src="https://www.google.com/maps/embed?..."></iframe>
    </div>
  </div>
</div>

Caractères alacon

  • ’ -> '
  • “ ” « » -> "
  • … -> ...
  • oe -> œ
  • °

Voir Character Entities Cheat Sheet : https://oinam.github.io/entities/

Conventions de style

Tags/hashtags

Règles sur Twitter :

  • 1 seul mot court en lowercase : #sport
  • Accents autorisés : #ostéopathie #osteopathie
  • Mot composé sans espace ni ponctuation : #FemmeEnceinte
  • Les hashtags sont insensibles à la case : #sport #Sport
  • Pas plus de 2 tags par tweet
  • Ne pas utiliser un hashtag controversé ou lié à une polémique
  • Jekyll YAML Front Matter: tags: [ostéopathie, TMS]

Sitemap

Hébergement

Amazon Simple Storage Service (S3), Route 53 DNS, CloudFront CDN

SEO

Outils

Documentation

Minification

Optimisation des images

Validation du site

Multilingue

Meta data

Outils

Emuler Android stock browser

Installer Android Studio

./Library/Android/sdk/tools/android
./Library/Android/sdk/tools/android avd

About

https://osteo15.com

Languages

Language:HTML 46.0%Language:SCSS 29.5%Language:Ruby 18.7%Language:JavaScript 3.1%Language:Shell 2.7%