--- title: "Katkıda Bulunmak | open.mp" description: "SA-MP ve open.mp wikisine katkıda bulunmak istiyorsanız bu başlığı inceleyebilirsiniz." canonical: https://omp.itsneufox.com/tr/docs/meta/Contributing language: tr --- # Katkıda Bulunmak Bu dökümantasyon kaynağı katkıda bulunmak isteyen herkese açıktır. İhtiyacınız olan şeyler [GitHub](https://github.com) üzerinden bir hesap ve birazcık boş zaman. Git'i bilmenize gerek yok, giriş yaptığınız arayüz web arayüzünden her şeyi yapabilirsiniz. Belirli bir dilin sayfasını yaratmak istiyorsanız, [`CODEOWNERS`](https://github.com/openmultiplayer/web/blob/master/CODEOWNERS) dosyasına diliniz ve kullanıcı adınızı içeren bir satır yazın. (TR sayfalarını geliştirecekseniz bu sayfayı düzenlemenize gerek yok). ## İçerik Düzenlemek Her sayfada düzenleme yapabilmek Github düzenleme sayfasına yönlendiren buton vardır. ![Edit this page link present on each wiki page](https://assets.open.mp/assets/images/contributing/edit-this-page.png) Örneğin, [SetVehicleAngularVelocity](https://omp.itsneufox.com/tr/docs/scripting/functions/SetVehicleAngularVelocity) bu tıklatma [bu sayfa](https://github.com/openmultiplayer/web/edit/master/frontend/docs/scripting/functions/SetVehicleAngularVelocity.md) sizi bu dosya üzerinde değişiklik yapmanız için yönlendirir. (eğer ki github üzerinden oturum açtıysanız). Düzenlemenizi yapın ve bir "Pull Request" gönderin. Wiki üzerinde çalışan takım üyeleri yaptığınız değişiklikleri onaylandığında(incelenmesi ardından) yaptığınız değişiklikler yayınlanır. ## Yeni Bir İçerik Eklemek Yeni içerik eklemek biraz daha fazla ilgi ister. Bunu iki şekilde yapabilirsiniz: ### Github Web Arayüzünü Kullanmak Github'da bir dizine göz atarken dosya listeninin en sağ üst köşesinde bir "Add File(Dosya Ekle)" düğmesini göreceksiniz. ![Add file button](https://assets.open.mp/assets/images/contributing/add-new-file.png) Önceden yazdığınız bir Markdown(.md) dosyasını yükleyebilir veya doğrudan GitHub metin düzenleyicisini kullanarak yeni bir içerik ekleyebilirsiniz. Yarattığınız dosyaların bir uzantısı olmalı ve bu uzantı Markdown(.md) olmalıdır. Markdown hakkında daha fazla bilgi için bu dökümasyona göz atabilirsin. [this guide](https://guides.github.com/features/mastering-markdown/). Bu aşamalar bittikten sonra "Propose new file" tuşuna basarsanız "Pull Request" sayfasına yönlendirilirsiniz ve "İçerik Düzenlemek" başlığında yazıldığı gibi yeni içeriğinizi yaratabilirsiniz. ### Git Eğer Git'i kullanmak istiyorsanız, tek yapmanız gereken Wiki dosyalarını aşağıdaki kod ile klonlamaktır. ```sh git clone https://github.com/openmultiplayer/web.git ``` En sevdiğiniz editörü açın. Ben düzenleme yapmak için Visual Studio Code'yi öneriyorum. Markdown dosyalarını biçimlendirmek için güzel bir editör ve gördüğünüz gibi ben Visual Studio Code kullanıyorum. ![Visual Studio Code markdown preview](https://assets.open.mp/assets/images/contributing/vscode.png) Bu işlemleri kolaylaştırmak ve daha rahat hale getirmek için iki Visual Studio Code eklentisi öneriyoruz. - [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) by David Anson - this is an extension that makes sure your Markdown is formatted correctly. It prevents some syntactical and semantic mistakes. Not all the warnings are important, but some can help improve readability. Use best judgement and if in doubt, just ask a reviewer! - [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) by the Prettier.js Team - this is a formatter that will automatically format your Markdown files so they all use a consistent style. The Wiki repository has some settings in its `package.json` that the extension should automatically use. Be sure to enable "Format On Save" in your editor settings so your Markdown files will be automatically formatted every time you save! ## Notlar, İpuçları ve Conventions ### Linkler Siteler arası bağlantılar için doğrudan URL'leri kullanmayın. Göreli yollar ile URL'leri tanıtın. Demek istenilen: - ❌ ```md To be used with [OnPlayerClickPlayer](https://www.open.mp/docs/scripting/callbacks/OnPlayerClickPlayer) ``` - ✔ ```md To be used with [OnPlayerClickPlayer](../callbacks/OnPlayerClickPlayer) ``` `../` olarak gördüğünüz şey "Bir dizin yukarı git" anlamına gelir, yani eğer `functions` klasörünün içerisindeki bir dosyayı düzenlerken `callbacks` klasörünün içerisindeki bir dosyaya yönlendirme yapmak istiyorsanız `../` kullanarak `scripting/` klasörüne geçmeli ve `callbacks/` yazarak callbacks klasörüne girmelisiniz, aradığınız dosyanın uzantısını eklemeden (`.md` olmadan) tanıtmalısınız. ### Resimler Resimler '/static/images' klasörünün içerisindeki bir alt dizine girer. Bir görüntüyü `![]()` ile gösterebilirsiniz. Temel yol olarak `/images/` kullanıyorsunuz. Eğer nasıl yapılacağını anlamadıysanız (anlatım İngilizce olarak da biraz sorunluydu bu yüzden biraz yanlış yazılmış olabilir). Başka sayfalarda resimlerin nasıl yayınlandığını inceleyin ve kopyalayıp yapıştırın. ### Meta Verileri _Herhangi_ bir sayfada ilk şey meta verileri olmalıdır: ```mdx --- title: Benim Döküm Sayfam sidebar_label: Benim Döküm Sayfam description: Bu sayfa eşyalar ve burgerler hakkında bir sayfa, yaşasın! --- ``` Her sayfanın bir başlığı ve bir açıklaması olmalıdır. `---`, etiketlerinin arasında nelerin bulunabileceği için dökümasyonu inceleyin. [the Docusaurus documentation](https://docusaurus.io/docs/markdown-features#markdown-headers). ### Başlıklar seviye 1 başlık için (`

`) kullanmayın. `#` otomatik olarak oluşturduğu için _her zaman_ `##` ile 1. seviye başlık belirleyin. - ❌ ```md # Benim Başlığım Bu dökümasyon ... için # Sub-Section ``` - ✔ ```md Bu dökümasyon ... için ## Alt Bölüm ``` ### Use `Code` Snippets For Technical References When writing a paragraph that contains function names, numbers, expressions or anything that's not standard written language, surround them with \`backticks\` like that. This makes it easier to separate language for describing things from references to technical elements such as function names and pieces of code. - ❌ > The fopen function will return a value with a tag of type File:, there is no problem on that line as the return value is being stored to a variable also with a tag of File: (note the cases are the same too). However on the next line the value 4 is added to the file handle. 4 has no tag \[...\] - ✔ > The `fopen` function will return a value with a tag of type `File:`, there is no problem on that line as the return value is being stored to a variable also with a tag of `File:` (note the cases are the same too). However on the next line the value `4` is added to the file handle. `4` has no tag In the above example, `fopen` is a function name, not an English word, so surrounding it with `code` snippet markers helps distinguish it from other content. Also, if the paragraph is referring to a block of example code, this helps the reader associate the words with the example. ### Tables If a table has headings, they go in the top part: - ❌ ```md | | | | ------- | ------------------------------------ | | Health | Engine Status | | 650 | Undamaged | | 650-550 | White Smoke | | 550-390 | Grey Smoke | | 390-250 | Black Smoke | | < 250 | On fire (will explode seconds later) | ``` - ✔ ```md | Health | Engine Status | | ------- | ------------------------------------ | | 650 | Undamaged | | 650-550 | White Smoke | | 550-390 | Grey Smoke | | 390-250 | Black Smoke | | < 250 | On fire (will explode seconds later) | ``` ## Migrating from SA-MP Wiki Most of the content has been moved, but if you find a page that's missing, here's a short guide for converting content to Markdown. ### Getting the HTML 1. Click this button (Firefox) ![image](https://assets.open.mp/assets/images/contributing/04f024579f8d.png) (Chrome) ![image](https://assets.open.mp/assets/images/contributing/f62bb8112543.png) 2. Hover the top left of the main wiki page, in the left margin or the corner until you see `#content` ![image](https://assets.open.mp/assets/images/contributing/65761ffbc429.png) Or search for `
` ![image](https://assets.open.mp/assets/images/contributing/77befe2749fd.png) 3. Copy the inner HTML of that element ![image](https://assets.open.mp/assets/images/contributing/8c7c75cfabad.png) Now you have _only_ the HTML code for the actual _content_ of the page, the stuff we care about, and you can convert it to Markdown. ### Converting HTML to Markdown For converting basic HTML (no tables) to Markdown use: [https://mixmark-io.github.io/turndown/](https://mixmark-io.github.io/turndown/) ![image](https://assets.open.mp/assets/images/contributing/77f4ea555bbb.png) ^^ Notice now it screwed up the table completely... ### HTML Tables to Markdown Tables Because the above tool does not support tables, use this tool: [https://jmalarcon.github.io/markdowntables/](https://jmalarcon.github.io/markdowntables/) And copy only the `` element in: ![image](https://assets.open.mp/assets/images/contributing/57f171ae0da7.png) ### Cleaning Up The conversion likely won't be perfect. So you'll have to do a bit of manual cleanup. The formatting extensions listed above should help with that but you may still need to just spend some time doing manual work. If you don't have time, don't worry! Submit an unfinished draft and someone else can pick up where you left off! ## License Agreement All open.mp projects have a [Contributor License Agreement](https://cla-assistant.io/openmultiplayer/homepage). This basically just means you agree to let us use your work, and put it under an open-source license. When you open a Pull Request for the first time, the CLA-Assistant bot will post a link where you can sign the agreement.