mirror of
https://github.com/treffynnon/sqlstyle.guide.git
synced 2025-03-09 12:49:51 -05:00
78 lines
4.1 KiB
Markdown
78 lines
4.1 KiB
Markdown
# SQL style guide
|
|
|
|
**[☛ Read the guide](https://www.sqlstyle.guide)**
|
|
|
|
---
|
|
|
|
## General
|
|
|
|
The guide is written in [Markdown][md-lang] and uses [Jekyll][jekyll] via
|
|
[GitHub's Pages][gh-pages] facility to render itself upon pushing to the `gh-pages`
|
|
branch.
|
|
|
|
## Sources
|
|
|
|
The markdown source for the guide can be found in [_includes/sqlstyle.guide.md][md]
|
|
|
|
## Installing for local development
|
|
|
|
There is a Gemfile supplied so you just need to follow the
|
|
[GitHub Pages documentation][gh-pages-help] to install the dependencies.
|
|
|
|
To then run it locally `bundle exec jekyll serve`
|
|
|
|
## Translations of the guide
|
|
|
|
If you would like to translate the guide then please open a pull request or open an issue
|
|
if you need some help getting it setup.
|
|
|
|
* [German/Deutsch](https://www.sqlstyle.guide/de/) by [AStasyK](https://github.com/AStasyK)
|
|
* [French/Français](https://www.sqlstyle.guide/fr/) by [IdrissaD](https://github.com/IdrissaD)
|
|
* [Italian/Italiano](https://www.sqlstyle.guide/it/) by [robertopauletto](https://github.com/robertopauletto)
|
|
* [Japanese/日本語](https://www.sqlstyle.guide/ja/) by [nkurigit](https://github.com/nkurigit)
|
|
* [Korean/한국어](https://www.sqlstyle.guide/ko/) by [Dokyeongyun](https://github.com/Dokyeongyun)
|
|
* [Polish/Polski](https://www.sqlstyle.guide/pl/) by [andre-wojtowicz](https://github.com/andre-wojtowicz)
|
|
* [Portuguese (Brazil)/Português (BR)](https://www.sqlstyle.guide/pt-br/) by [pmarcus93](https://github.com/pmarcus93)
|
|
* [Russian/Русский](https://www.sqlstyle.guide/ru/) by [denpatin](https://github.com/denpatin)
|
|
* [Simplified Chinese/简体中文](https://www.sqlstyle.guide/zh/) by [wontoncoder](https://github.com/wontoncoder)
|
|
* [Traditional Chinese/正體中文](https://www.sqlstyle.guide/zh-tw/) by [Leon0824](https://github.com/Leon0824)
|
|
* [Turkish/Türkçe](https://www.sqlstyle.guide/tr/) by [mrfade](https://github.com/mrfade)
|
|
* [Ukrainian/Українська](https://www.sqlstyle.guide/ua/) by [yar-lukomsky](https://github.com/yar-lukomsky)
|
|
* [Vietnamese/Tiếng Việt](https://www.sqlstyle.guide/vn/) by [Vũ Phượng Hoàng](https://github.com/DancingPhoenix88)
|
|
|
|
## Projects known to be implementing the guide
|
|
|
|
If your project uses this styleguide and you'd like to be mentioned in this readme then
|
|
please open a pull request adding it below in alphabetical order with a URL and short
|
|
description.
|
|
|
|
You can also add a badge ([](https://www.sqlstyle.guide/)) to your projects readme with the following markdown code if you like:
|
|
|
|
```markdown
|
|
[](https://www.sqlstyle.guide/)
|
|
```
|
|
|
|
* [BEdita](https://github.com/bedita/bedita) - a Symfony based PHP CMF
|
|
* [SQLQuery.jl](https://github.com/yeesian/SQLQuery.jl) - A Julia lang package for representing sql queries, and converting them to valid SQL statements
|
|
* [Stock Talk](https://github.com/nigelgilbert/stock-talk) - a realtime dashboard that displays the stock data of the most Tweeted Nasdaq companies.
|
|
|
|
## Notable forks of the guide
|
|
|
|
These are based on, but deviate in some way from sqlstyle.guide.
|
|
|
|
If you have forked this styleguide and you'd like to be mentioned in this readme then
|
|
please open a pull request adding it below in alphabetical order with a URL and short
|
|
description of your deviance.
|
|
|
|
* [Lumos Labs](https://github.com/lumoslabs/sqlstyle.guide) - removed the river, Redshift, etc. [www](https://engineering.lumosity.com/sqlstyle.guide)
|
|
* [Mozilla](https://github.com/mozilla/firefox-data-docs/blob/master/concepts/sql_style.md) - removed the river, heavily modified [www](https://docs.telemetry.mozilla.org/concepts/sql_style.html)
|
|
* [Ricardo.ch](https://ricardo-ch.github.io/sqlstyle.guide/)
|
|
* [Scout24](https://github.com/Scout24/sqlstyle.guide)
|
|
|
|
|
|
[md-lang]: https://daringfireball.net/projects/markdown/
|
|
[jekyll]: https://jekyllrb.com/
|
|
[gh-pages]: https://pages.github.com/
|
|
[md]: https://github.com/treffynnon/sqlstyle.guide/blob/gh-pages/_includes/sqlstyle.guide.md
|
|
[gh-pages-help]: https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/
|
|
|