mirror of
https://github.com/codeguy/php-the-right-way.git
synced 2025-08-06 14:06:34 +02:00
91 lines
3.8 KiB
Markdown
91 lines
3.8 KiB
Markdown
# PHP: The Right Way
|
|
|
|
## Overview
|
|
|
|
This is the GitHub Pages repository for the _PHP: The Right Way_ project.
|
|
|
|
* This website is a Jekyll project.
|
|
* Each section and sub-section are a Markdown file in `_posts/`.
|
|
* Sub-sections have `isChild: true` in their front matter.
|
|
* The navigation and page structure are automatically generated.
|
|
|
|
## Spread the Word!
|
|
|
|
_PHP: The Right Way_ has web banner images you can use on your website. Show your support, and let new PHP
|
|
developers know where to find good information!
|
|
|
|
[See Banner Images](https://www.phptherightway.com/banners.html)
|
|
|
|
## How to Contribute
|
|
|
|
You should read the `CONTRIBUTING.md` file for precise instructions and tips. But, if you prefer a TL;DR:
|
|
|
|
1. Fork and edit
|
|
2. Optionally install [Ruby](https://rvm.io/rvm/install/) with [Jekyll](https://github.com/mojombo/jekyll/) gem to preview locally
|
|
3. Submit pull request for consideration
|
|
|
|
### Contributor Style Guide
|
|
|
|
1. Use American English spelling (*primary English repo only*).
|
|
2. Use four (4) spaces to indent text; do not use tabs.
|
|
3. Wrap all text to 120 characters.
|
|
4. Code samples should adhere to PSR-1 or higher.
|
|
|
|
## Where
|
|
|
|
<https://www.phptherightway.com>
|
|
|
|
* [English](https://www.phptherightway.com)
|
|
* [Español](https://phpdevenezuela.github.io/php-the-right-way)
|
|
* [Français](https://eilgin.github.io/php-the-right-way/)
|
|
* [Indonesia](https://id.phptherightway.com)
|
|
* [Italiano](https://it.phptherightway.com)
|
|
* [Polski](https://pl.phptherightway.com)
|
|
* [Português do Brasil](https://br.phptherightway.com)
|
|
* [Română](https://bgui.github.io/php-the-right-way/)
|
|
* [Slovenščina](https://sl.phptherightway.com)
|
|
* [Srpski](https://phpsrbija.github.io/php-the-right-way/)
|
|
* [Türkçe](https://hkulekci.github.io/php-the-right-way/)
|
|
* [български](https://bg.phptherightway.com)
|
|
* [Русский язык](https://getjump.github.io/ru-php-the-right-way)
|
|
* [Українська](https://iflista.github.io/php-the-right-way/)
|
|
* [العربية](https://adaroobi.github.io/php-the-right-way/)
|
|
* [فارسى](https://novid.github.io/php-the-right-way/)
|
|
* [ภาษาไทย](https://apzentral.github.io/php-the-right-way/)
|
|
* [한국어판](https://modernpug.github.io/php-the-right-way)
|
|
* [日本語](https://ja.phptherightway.com)
|
|
* [简体中文](https://laravel-china.github.io/php-the-right-way/)
|
|
* [繁體中文](https://laravel-taiwan.github.io/php-the-right-way)
|
|
|
|
### Translations
|
|
|
|
If you are interested in translating _PHP: The Right Way_, fork this repo on GitHub and publish your localized fork to your own GitHub Pages account. We'll link to your translation from the primary document.
|
|
|
|
To avoid fragmentation and reader confusion, please choose one of these options:
|
|
|
|
1. We link to your GitHub Pages fork with `[username].github.io/php-the-right-way`
|
|
2. We link to your GitHub Pages fork with a subdomain (e.g. "ru.phptherightway.com")
|
|
|
|
If you use a subdomain, enter the subdomain into the `CNAME` file, and ask us to setup DNS for you. If you do not use a subdomain, remove the `CNAME` file entirely else your fork will not build when pushed.
|
|
|
|
Add information about your translation in the [wiki page](https://github.com/codeguy/php-the-right-way/wiki/Translations).
|
|
|
|
When your translation is ready, open an issue on the Issue Tracker to let us know.
|
|
|
|
## Why
|
|
|
|
There's been a lot of discussion lately about how the PHP community lacks sufficient, credible information for programmers new to PHP. This repository aims to solve this problem.
|
|
|
|
## Who
|
|
|
|
My name is [Josh Lockhart](https://x.com/codeguy). I'm the author of the [Slim Framework](https://www.slimframework.com/), and I work for [New Media Campaigns](https://www.newmediacampaigns.com/).
|
|
|
|
### Collaborators
|
|
|
|
* [Kris Jordan](https://krisjordan.com/)
|
|
* [Phil Sturgeon](https://phil.tech/)
|
|
|
|
## License
|
|
|
|
[Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License](https://creativecommons.org/licenses/by-nc-sa/3.0/)
|