https://github.com/tkrotoff/osteo15
https://github.com/tkrotoff/osteo15
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/tkrotoff/osteo15
- Owner: tkrotoff
- Created: 2015-02-16T01:42:33.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2023-04-11T12:03:44.000Z (about 3 years ago)
- Last Synced: 2026-01-15T08:05:49.095Z (5 months ago)
- Language: HTML
- Homepage: https://osteo15.com
- Size: 44.3 MB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Osteo15 blog
[osteo15.com](https://osteo15.com/)
```Shell
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
```
```Shell
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:
```Shell
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](https://jekyllrb.com/docs/liquid/tags/#linking-to-posts) de Jekyll :
```HTML
{% 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 [`\/:*?"<>|`](https://msdn.microsoft.com/en-us/library/aa365247), 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](https://github.com/jekyll/jekyll/issues/2834) 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-._~:/?#[]@!$&'()*+,;=`](https://stackoverflow.com/q/1547899)
### URLs
Par exemple, les espaces ne sont pas autorisés : [HTML href syntax: is it okay to have space in file name?](https://stackoverflow.com/q/4172579).
Il faut utiliser [cgi_escape](https://jekyllrb.com/docs/liquid/filters/).
Exemple :
```HTML
```
post_url ne fonctionne pas avec des accents, exemple :
```Markdown
[la micronutrition]({% post_url 2014-03-25-Introduction-à-la-micronutrition %})
[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) :
```Markdown
```
## Formats des images
- Le format non destructeur [PNG](https://fr.wikipedia.org/wiki/Portable_Network_Graphics) (.png) adapté pour les images simples comprenant des aplats de couleurs
- Le format destructeur [JPEG](https://fr.wikipedia.org/wiki/JPEG) (.jpg) pour la photographie
## Figures
```HTML
{% 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" %}
```
```HTML
{% 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" %}
```
```HTML
Lombalgies symptomatiques [^2]
```
## Grille HTML
Voir la documentation de Bootstrap : https://getbootstrap.com/docs/3.4/css/#grid
## Intégration d'une vidéo
```HTML
{% include embed-responsive-4by3.html src="https://www.youtube.com/embed/VJo5z11rUYQ" %}
```
## Intégration d'une carte Google Maps
```HTML
```
## Caractères alacon
- ’ -> '
- “ ” « » -> "
- … -> ...
- oe -> œ
- °
Voir Character Entities Cheat Sheet : https://oinam.github.io/entities/
## Conventions de style
- https://fr.wikipedia.org/wiki/Wikip%C3%A9dia:Conventions_de_style
- https://en.wikipedia.org/wiki/Wikipedia:Manual_of_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
- [Jekyll Sitemap Generator Plugin](https://github.com/jekyll/jekyll-sitemap)
- [Building a Better Sitemap.xml with Jekyll](https://davidensinger.com/2013/11/building-a-better-sitemap-xml-with-jekyll/)
- [Sitemaps XML format](https://www.sitemaps.org/protocol.html)
- [Rakefile example for Jekyll](https://github.com/chrisanthropic/slim-pickins-jekyll-theme/blob/b78100385c83d7aa574742fd9494e10c20797147/Rakefile)
## Hébergement
Amazon Simple Storage Service (S3), Route 53 DNS, CloudFront CDN
- [Hosting a Static Website on Amazon Web Services](https://docs.aws.amazon.com/gettingstarted/latest/swh/website-hosting-intro.html)
- [Hosting a static (Jekyll) blog on Amazon S3](https://www.savjee.be/2013/02/howto-host-jekyll-blog-on-amazon-s3/)
- [Enable gzip for Jekyll blogs on Amazon S3](https://www.savjee.be/2014/03/Jekyll-to-S3-deploy-script-with-gzip/)
- [Static website on S3, CloudFront and Route 53, the right way!](https://www.michaelgallego.fr/blog/2013/08/27/static-website-on-s3-cloudfront-and-route-53-the-right-way/)
- [Avoiding the Duplicate Content Penalty with AWS S3 and CloudFront](https://bryce.fisher-fleig.org/blog/avoiding-duplicate-content-penalty-with-aws-s3-and-cloudfront/)
## SEO
### Outils
- [Google Webmaster](https://www.google.com/webmasters/)
- [Bing Webmaster Tools](https://www.bing.com/toolbox/webmaster)
- [WebPage Test - Test a website's performance](https://www.webpagetest.org/)
- [GTmetric - Perfomance Analysis](https://gtmetrix.com/)
- [Pingdom Speed Test](https://tools.pingdom.com/fpt/)
- [Improving your Blog visibility](https://blog.penso.info/2015/03/21/improve-blog-visibility/)
- [24 outils pour mesurer et optimiser les temps de chargement de votre site web](https://korben.info/23-outils-pour-mesurer-et-optimiser-les-temps-de-chargement-de-votre-site-web.html)
### Documentation
- [Google - Search Engine Optimization Starter Guide](https://www.google.com/webmasters/docs/search-engine-optimization-starter-guide.pdf)
- [OpenClassrooms - Améliorez la visibilité de votre site grâce au référencement](https://openclassrooms.com/courses/ameliorez-la-visibilite-de-votre-site-grace-au-referencement)
- [SEO Best Practices 2014](https://www.slideshare.net/PierreMFioriniPhD/seo-best-practices-for-2014-beyond-dd)
## Minification
- [Octopress Minify Html](https://github.com/octopress/minify-html)
- [Speeding up Jekyll site](https://dmytro.github.io/2013/10/29/optimizing_jekyll.html)
- [How I use Reduce to Minify and Optimize Assets for Production](https://davidensinger.com/2013/08/how-i-use-reduce-to-minify-and-optimize-assets-for-production/)
## Optimisation des images
- [ImageOptim](https://imageoptim.com/)
- [image_optim](https://github.com/toy/image_optim)
- [image_optim-jekyll-plugin](https://github.com/chrisanthropic/image_optim-jekyll-plugin)
## Validation du site
- [Jekyll - The Test script](https://jekyllrb.com/docs/continuous-integration/#the-test-script)
- [HTML::Proofer](https://github.com/gjtorikian/html-proofer)
- [validate-website](https://github.com/spk/validate-website)
## Multilingue
- [Jekyll: Multilingual](https://kleinfreund.de/en/2014/08/jekyll-multilingual/)
## Meta data
- [GitHub davidensinger.github.io](https://github.com/davidensinger/davidensinger.github.io/blob/8845520aa2d09d05a8f171c6cff40f5d1bbca657/app/_includes/header.html)
- [Adding schema.org metadata to Jekyll](https://veithen.github.io/2014/11/17/jekyll-schema-org-metadata.html)
### Outils
- [Google Structured Data Testing Tool](https://developers.google.com/structured-data/testing-tool/)
- [Google+ Snippet](https://developers.google.com/+/web/snippet/)
- [Facebook Debugger](https://developers.facebook.com/tools/debug/)
- [Twitter card validator](https://cards-dev.twitter.com/validator)
- [Structured Data Linter](https://linter.structured-data.org/)
- [Yandex Structured data validator](https://webmaster.yandex.com/microtest.xml)
## Emuler Android stock browser
Installer Android Studio
```Shell
./Library/Android/sdk/tools/android
./Library/Android/sdk/tools/android avd
```