Difference between revisions of "Getting Started (Türkçe)"

(Bir buçuk heading çevirdim. Gelecek çevirmenler için kelimeler hakkında birkaç not bıraktım.)
 
(Çevrilmemiş kısmın bir kısmı tamamlandı.)
Line 1: Line 1:
 
== LÖVE'yi Edinmek ==
 
== LÖVE'yi Edinmek ==
  
LÖVE'nin [http://love2d.org/#download internet sitesinden] en güncel sürümünü indirip kurun. Eğer Windows kullanıyor ve LÖVE'yi ''kurmak'' istemiyorsanız, zip arşivlenmiş çalıştırılabilirleri indirip istediğiniz yere çıkarabilirsiniz.
+
LÖVE'nin [http://love2d.org/#download internet sitesinden] en güncel sürümünü indirip kurun. Eğer Windows kullanıyor ve LÖVE'yi ''kurmak'' istemiyorsanız, ziplenmiş çalıştırılabilir dosyaları herhangi bir yere çıkarabilirsiniz.
  
LÖVE'nin kurulu sürümünün numarasını görmek için şu komudu çalıştırın:
+
Hangi LÖVE sürümünün kurulu olduğunu görmek için şu komutu çalıştırın:
  
 
<source lang="bash">
 
<source lang="bash">
Line 9: Line 9:
 
</source>
 
</source>
  
== Oyun Yaratmak ==
+
Unutmayın, LÖVE'yi komut satırından çalıştırabilmek için LÖVE'nin bulunduğu klasörü sisteminizin PATH değişkenine eklemeniz gerekebilir.
  
Basit bir oyun yaratmak için yeni bir klasör oluşturup istediğiniz metin düzenleyicisini açın. [http://www.sublimetext.com Sublime Text] güzeldir, kendinden Lua'yı destekler ve çoğu işletim sisteminde çalışır. Klasörünüzde <code>main.lua</code> adlı bir dosya yaratıp içerisine şu kodu yerleştirin:
+
== Oyun Yapmak ==
 +
 
 +
Küçük bir oyun yapmak için yeni bir klasör oluşturup istediğiniz metin düzenleyicisini açın. [http://www.sublimetext.com Sublime Text] güzeldir, kendinden Lua'yı destekler ve çoğu işletim sisteminde çalışır. Klasörünüzde <code>main.lua</code> adlı bir dosya oluşturup içerisine şu kodu yerleştirin ve kaydedin:
  
 
<source lang="lua">
 
<source lang="lua">
Line 18: Line 20:
 
end
 
end
 
</source>
 
</source>
== Running Games ==
+
== Oyunları Çalıştırmak ==
  
 
LÖVE oyunları iki şekilde başlatabilir:
 
LÖVE oyunları iki şekilde başlatabilir:
 
* <code>main.lua</code> dosyasını içeren bir klasörden.
 
* <code>main.lua</code> dosyasını içeren bir klasörden.
* From a [[LÖVE Game File|.love file]] that has a main.lua file in the top-most directory level (veya root)
+
* En üstteki (yani kök) dizininde <code>main.lua</code> bulunan bir [[LÖVE Game File (Türkçe)|.love dosyasından]].
  
For creating .love files see [[Game Distribution]].
+
\.love dosyalarını oluşturmak için bkz.: [[Game Distribution (Türkçe)|Oyun Dağıtımı]]
  
 +
----
 
=== Windows ===
 
=== Windows ===
  
[http://studio.zerobrane.com ZeroBrane Studio], [[Sublime Text]], [[Notepad++]], and [[SciTE]] allow you to launch the game from within their code editors.
+
[http://studio.zerobrane.com ZeroBrane Studio], [[Sublime Text]], [[Notepad++]], ve [[SciTE]]; oyunu kod editörünün içinden başlatmanıza izin verir.
  
Otherwise, the easiest way to çalıştır the game is to drag the folder onto either love.exe or a kısayol to love.exe. Remember to drag the folder containing <code>main.lua</code>, and not <code>main.lua</code> itself.
+
Onun dışında oyunu çalıştırmanın en kolay yolu oyunu love.exe veya love.exe'ye giden bir kısayola sürüklemektir. <code>main.lua</code>'nın kendisini değil, <code>main.lua</code>'yı içeren klasörü sürüklemeniz gerektiğini unutmayın.
  
You can also launch the game from the command line:
+
Oyunu komut satırından da çalıştırabilirsiniz:
  
 
<source lang="powershell">
 
<source lang="powershell">
"C:\Program Files\LOVE\love.exe" "C:\games\mygame"
+
"C:\Program Files\LOVE\love.exe" "C:\oyunlar\oyunum"
"C:\Program Files\LOVE\love.exe" "C:\games\packagedgame.love"
+
"C:\Program Files\LOVE\love.exe" "C:\oyunlar\paketlenmişoyun.love"
 
</source>
 
</source>
  
You can create a kısayol to do this; simply make a kısayol to love.exe, right-click on it and select "Properties", and then put the command line you want in the "Target" box for the kısayol.
+
Bunu yapmak için kısayol oluşturabilirsiniz. love.exe için kısayol oluşturun, sağ tıklayın ve "Özellikler"i seçin, daha sonra istediğiniz komut satırını "Dizin" kısmına yerleştirin.
  
On Windows, there is a special komut-satırı seçeneği which will attach a konsol to the window, allowing you to see the result of <code>print</code> çağırıları (equivalent to setting <code>t.console=true</code> in [[conf.lua]] or running <code>lovec.exe</code> (since [[0.10.2]]):
+
Windowsta pencereye bir konsol iliştirerek <code>print</code> çağrısının sonucunu görmenizi sağlayan özel bir komut satırı seçeneği vardır ([[conf.lua (Türkçe)|conf.lua]]'da <code>t.console=true</code> yapmak veya ([[0.10.2]]'den beri) <code>lovec.exe</code>'yi çalıştırmak ile eşdeğer):
<source lang="powershell">
+
<source lang="bash">
 
"C:\Program Files\LOVE\love.exe" --console
 
"C:\Program Files\LOVE\love.exe" --console
 
</source>
 
</source>
Line 50: Line 53:
 
===Linux===
 
===Linux===
  
On Linux, you can use one of these komutlar:
+
Linux'ta bu komut satırlarından birini kullanabilirsiniz:
  
 
<source lang="bash">
 
<source lang="bash">
love /home/path/to/gamedir/
+
love /home/dosya/yolu/oyundizini
love /home/path/to/packagedgame.love
+
love /home/dosya/yolu/paketlenmisoyun.love
 
</source>
 
</source>
  
If you installed LÖVE system-wide, you can double click on .love files in your file manager as well.
+
Ayrıca LÖVE'yi sistem genelinde kurduysanız dosya yöneticinizde .love dosyalarına çift tıklayabilirsiniz.
  
 
----
 
----
 
=== macOS ===
 
=== macOS ===
  
On macOS, a folder or .love file can be dropped onto the love application bundle. On the Mac Terminal (command line), you can use love like this (assuming it's installed to the Applications dizini):
+
macOS'te bir klasör veya .love dosyası love uygulama paketine sürüklenebilir. Mac terminalinde (komut satırı) love'ı bu şekilde kullanabilirsiniz (Uygulamalar dizinine kurulu olması gerekir):
  
<source lang="bash">open -n -a love "~/path/to/mygame"</source>
+
<source lang="bash">open -n -a love "~/dosya/yolu/oyunum"</source>
  
However, the above method will not output printed text to the terminal window. To do that, you will need to execute the love binary inside the application bundle directly:  
+
Ancak yukarıdaki yöntem <code>print</code> edilen yazıları terminal penceresine çıkarmaz. Bunu yapmak için uygulama paketindeki love çalıştırılabilir dosyasını doğrudan çalıştırmanız gerekir:
  
<source lang="bash">/Applications/love.app/Contents/MacOS/love ~/path/to/mygame</source>
+
<source lang="bash">/Applications/love.app/Contents/MacOS/love ~/dosya/yolu/oyunum</source>
  
You can set up an alias in your Terminal oturumu to call the yürütülebilir when you use <code>love</code> by adding an alias to your <code>~/.zshrc</code> file (Z shell configuration file).
+
<code>love</code> adıyla çalıştırılabilir dosyayı çağırmak için <code>~/.zshrc</code> dosyanıza (Z shell yapılandırma dosyası) "alias" ekleyerek terminal oturumunuzda "alias" kurabilirsiniz.
  
Open the file with
+
Dosyayı şununla açın:
 
<source lang="bash">open -a TextEdit ~/.zshrc</source>
 
<source lang="bash">open -a TextEdit ~/.zshrc</source>
  
You may have to run
+
Eğer dosya henüz mevcut değilse ilk önce
 
<source lang="bash">touch ~/.zshrc</source>
 
<source lang="bash">touch ~/.zshrc</source>
first if the file does not yet exist.
+
komutunu çalıştırmanız gerekebilir.
  
Then paste in the following code and save the file:
+
Sonra şu kodu yapıştırıp dosyayı kaydedin:
 
<source lang="bash">
 
<source lang="bash">
 
# alias to love
 
# alias to love
Line 85: Line 88:
 
</source>
 
</source>
  
Now you can call love from the komut satırı like Linux and Windows:
+
Artık loveLinux ve Windows'taki gibi komut satırından çağırabilirsiniz:
 +
 
 +
<source lang="bash">
 +
love ~/dosya/yolu/oyunum
 +
</source>
  
 +
Eğer bu işe yaramıyorsa .zshrc dosyasını şu şekilde yenilemeli:
 
<source lang="bash">
 
<source lang="bash">
love ~/path/to/mygame
+
source ~/.zshrc
 
</source>
 
</source>
 +
ve yeniden denemelisiniz.
  
 
----
 
----
 
=== Android ===
 
=== Android ===
As long as you have LÖVE for Android installed from the Play Store or another source and assume you didn't download/use the "embed" suffix flavor, the following methods will work:
+
Android için LÖVE APK'sını resmî siteden yüklemiş olduğunuz sürece aşağıdaki yöntemler çalışacaktır:
 
 
* Transfer your game folder to <code>/sdcard/Android/data/org.love2d.android/files/games/lovegame</code> (<code>/sdcard/lovegame</code> also works in Pie and earlier) where <code>main.lua</code> is found at <code>/sdcard/Android/data/org.love2d.android/files/games/lovegame/main.lua</code>. In Android 11 or later, these directories only accessible through MTP in PC. Then run LÖVE for Android.
 
  
* Transfer/download a .love of your game to the device and click on it. Some file explorers will run the .love using LÖVE for Android. If it does not you can install ES File Explorer which will. If you use Dropbox, you can use that to open .love files. May not work in Android Nougat or later due to Android restrictions.
+
* Oyun klasörünüzü <code>/sdcard/Android/data/org.love2d.android/files/games/lovegame</code> dizinine taşıyın (Android Pie ve daha öncekilerde <code>/sdcard/lovegame</code> de çalışır). <code>main.lua</code>'un <code>/sdcard/Android/data/org.love2d.android/files/games/loveoyunu/main.lua</code> konumunda bulunduğundan emin olun. Android 11 ve öncekilerde bu dizinler yalnızca bilgisayardan MTP aracılığıyla erişilebilir. Ardından Android için LÖVE'yi çalıştırın.
  
 +
* Oyununuzun .love dosyasını cihazınıza indirin/taşıyın ve dosyaya tıklayın. Bazı dosya yöneticileri .love'ı Android için LÖVE kullanarak çalıştıracak. Eğer çalıştırmazsa ES File Explorer'ı kurabilirsiniz. Eğer Dropbox kullanıyorsanız .love dosyalarını açmak için onu kullanabilirsiniz. Eğer işe yaramazsa LÖVE Loader'ı kullanarak .love dosyasını seçebilirsiniz.
  
 
If you have more questions, consider reading [https://github.com/love2d/love-android/wiki/FAQ---Frequently-Asked-Questions Android-specific FAQ]. If your question is not listed, then feel free to ask in the forums or the Discord.
 
If you have more questions, consider reading [https://github.com/love2d/love-android/wiki/FAQ---Frequently-Asked-Questions Android-specific FAQ]. If your question is not listed, then feel free to ask in the forums or the Discord.
Line 145: Line 153:
  
 
== Next steps ==
 
== Next steps ==
* [[Tutorial:Callback_Functions]] will teach you the basic structure of a LÖVE game.
+
* [[Tutorial:Callback_Functions]] will teach you the basic structure of a love game.
 
* [[:Category:Tutorials]] are the next piece of reading.
 
* [[:Category:Tutorials]] are the next piece of reading.
 
* [[Main Page|Wiki]] The LÖVE wiki.
 
* [[Main Page|Wiki]] The LÖVE wiki.

Revision as of 23:15, 25 February 2025

LÖVE'yi Edinmek

LÖVE'nin internet sitesinden en güncel sürümünü indirip kurun. Eğer Windows kullanıyor ve LÖVE'yi kurmak istemiyorsanız, ziplenmiş çalıştırılabilir dosyaları herhangi bir yere çıkarabilirsiniz.

Hangi LÖVE sürümünün kurulu olduğunu görmek için şu komutu çalıştırın:

love --version

Unutmayın, LÖVE'yi komut satırından çalıştırabilmek için LÖVE'nin bulunduğu klasörü sisteminizin PATH değişkenine eklemeniz gerekebilir.

Oyun Yapmak

Küçük bir oyun yapmak için yeni bir klasör oluşturup istediğiniz metin düzenleyicisini açın. Sublime Text güzeldir, kendinden Lua'yı destekler ve çoğu işletim sisteminde çalışır. Klasörünüzde main.lua adlı bir dosya oluşturup içerisine şu kodu yerleştirin ve kaydedin:

function love.draw()
    love.graphics.print("Merhaba dünya!", 400, 300)
end

Oyunları Çalıştırmak

LÖVE oyunları iki şekilde başlatabilir:

  • main.lua dosyasını içeren bir klasörden.
  • En üstteki (yani kök) dizininde main.lua bulunan bir .love dosyasından.

\.love dosyalarını oluşturmak için bkz.: Oyun Dağıtımı


Windows

ZeroBrane Studio, Sublime Text, Notepad++, ve SciTE; oyunu kod editörünün içinden başlatmanıza izin verir.

Onun dışında oyunu çalıştırmanın en kolay yolu oyunu love.exe veya love.exe'ye giden bir kısayola sürüklemektir. main.lua'nın kendisini değil, main.lua'yı içeren klasörü sürüklemeniz gerektiğini unutmayın.

Oyunu komut satırından da çalıştırabilirsiniz:

"C:\Program Files\LOVE\love.exe" "C:\oyunlar\oyunum"
"C:\Program Files\LOVE\love.exe" "C:\oyunlar\paketlenmişoyun.love"

Bunu yapmak için kısayol oluşturabilirsiniz. love.exe için kısayol oluşturun, sağ tıklayın ve "Özellikler"i seçin, daha sonra istediğiniz komut satırını "Dizin" kısmına yerleştirin.

Windowsta pencereye bir konsol iliştirerek print çağrısının sonucunu görmenizi sağlayan özel bir komut satırı seçeneği vardır (conf.lua'da t.console=true yapmak veya (0.10.2'den beri) lovec.exe'yi çalıştırmak ile eşdeğer):

"C:\Program Files\LOVE\love.exe" --console

Linux

Linux'ta bu komut satırlarından birini kullanabilirsiniz:

love /home/dosya/yolu/oyundizini
love /home/dosya/yolu/paketlenmisoyun.love

Ayrıca LÖVE'yi sistem genelinde kurduysanız dosya yöneticinizde .love dosyalarına çift tıklayabilirsiniz.


macOS

macOS'te bir klasör veya .love dosyası love uygulama paketine sürüklenebilir. Mac terminalinde (komut satırı) love'ı bu şekilde kullanabilirsiniz (Uygulamalar dizinine kurulu olması gerekir):

open -n -a love "~/dosya/yolu/oyunum"

Ancak yukarıdaki yöntem print edilen yazıları terminal penceresine çıkarmaz. Bunu yapmak için uygulama paketindeki love çalıştırılabilir dosyasını doğrudan çalıştırmanız gerekir:

/Applications/love.app/Contents/MacOS/love ~/dosya/yolu/oyunum

love adıyla çalıştırılabilir dosyayı çağırmak için ~/.zshrc dosyanıza (Z shell yapılandırma dosyası) "alias" ekleyerek terminal oturumunuzda "alias" kurabilirsiniz.

Dosyayı şununla açın:

open -a TextEdit ~/.zshrc

Eğer dosya henüz mevcut değilse ilk önce

touch ~/.zshrc

komutunu çalıştırmanız gerekebilir.

Sonra şu kodu yapıştırıp dosyayı kaydedin:

# alias to love
alias love="/Applications/love.app/Contents/MacOS/love"

Artık love'ı Linux ve Windows'taki gibi komut satırından çağırabilirsiniz:

love ~/dosya/yolu/oyunum

Eğer bu işe yaramıyorsa .zshrc dosyasını şu şekilde yenilemeli:

source ~/.zshrc

ve yeniden denemelisiniz.


Android

Android için LÖVE APK'sını resmî siteden yüklemiş olduğunuz sürece aşağıdaki yöntemler çalışacaktır:

  • Oyun klasörünüzü /sdcard/Android/data/org.love2d.android/files/games/lovegame dizinine taşıyın (Android Pie ve daha öncekilerde /sdcard/lovegame de çalışır). main.lua'un /sdcard/Android/data/org.love2d.android/files/games/loveoyunu/main.lua konumunda bulunduğundan emin olun. Android 11 ve öncekilerde bu dizinler yalnızca bilgisayardan MTP aracılığıyla erişilebilir. Ardından Android için LÖVE'yi çalıştırın.
  • Oyununuzun .love dosyasını cihazınıza indirin/taşıyın ve dosyaya tıklayın. Bazı dosya yöneticileri .love'ı Android için LÖVE kullanarak çalıştıracak. Eğer çalıştırmazsa ES File Explorer'ı kurabilirsiniz. Eğer Dropbox kullanıyorsanız .love dosyalarını açmak için onu kullanabilirsiniz. Eğer işe yaramazsa LÖVE Loader'ı kullanarak .love dosyasını seçebilirsiniz.

If you have more questions, consider reading Android-specific FAQ. If your question is not listed, then feel free to ask in the forums or the Discord.




iOS

In order to run LÖVE for iOS, it must first be compiled and installed. To do that, you’ll need macOS, Xcode 7 or newer, and the LÖVE for iOS source code downloadable from the home page.

  • If the libraries folder isn't present in the love/platform/xcode/ios folder, download the iOS libraries from the homepage, and place the iOS/libraries folder from the zip there. They contain the third-party library dependencies used by LÖVE.
  • Open the Xcode project found at love/platform/xcode/love.xcodeproj and select the love-ios target in the dropdown menu at the top of the window.
  • You may want to change the Build Configuration from Debug to Release for better performance, by opening the "Edit Scheme..." menu from the same dropdown selection.
  • Choose either an iOS Simulator device or your plugged-in iOS device in the dropdown selection to the right of the previous one, and click the Build-and-Run ▶︎ button to the left, which will install LÖVE on the target device after compiling it.


LÖVE on iOS includes a simple list interface of games that are installed (until you fuse a .love to it for distribution.)

  • To put a .love file on the iOS Simulator after LÖVE is installed, drag the file onto the iOS Simulator’s window while it’s open. LÖVE will launch if it’s not running already. If another game is currently active you may need to quit LÖVE for the new game to show up (press Shift-Command-H twice to open the App Switcher menu on the iOS Simulator.)
  • To put a .love file or game folder on your iOS device after LÖVE is installed, you can either download it with the Safari, or transfer it from your computer through iTunes when your device is connected: open iTunes, go to the iOS device which has LÖVE installed, go to the ‘Apps’ section and scroll down and find LÖVE, and add the .love file or game folder to LÖVE’s Documents section. On more recent iOS and Mac versions, you can use Airdrop to transfer your .love file from your Mac to where LÖVE is installed.


See the Game Distribution page for creating Fused LÖVE games on iOS and distributing them.


Note: for those interested in creating a LÖVE game directly on iOS, the Textastic app (available on the Apple App Store for purchase) can utilize SublimeText's packages-- one of which is a LÖVE package. You can follow these instructions to load that LÖVE package into the Textastic app on your iOS device to author LÖVE code directly on your iOS device. You'll then need to follow the earlier instructions on how to zip up that code into a .love file but then can either export that .love file to a LÖVE app running on your iOS device or an external device running a LÖVE application.

Instructions:

  1. Purchase the iOS Textastic app on the App Store
  2. Create a folder in Textastic (while inside the Textastic app "Local Files" section or in the iOS Files app under the Textastic folder) called "#Textastic"
  3. go to https://github.com/szensk/subllualove in Safari on your iPad
  4. tap the green "Code" button and select "Download ZIP"
  5. Unzip the file in the Files app. This will create a folder called "subllualove-master"
  6. Move or copy that folder into the folder "On my iPad/Textastic/#Textastic/". This is equivalent to this folder in Textastic: "Local Files/#Textastic/".
  7. In Textastic, go to Settings (gear wheel on the bottom left portion of the app) -> Other and tap "Reload Customizations"
  8. In File Properties (document looking icon on top right portion of the app) -> Syntax Definition, there is now a new item "LOVE (*.lua)" that you can select after opening a .lua file.

If you have any questions on this process, please contact the Textastic developer (very responsive by email support)

Next steps

Other Languages