Difference between revisions of "Getting Started (正體中文)"

(Created page with "== 下載 LÖVE == 從 [http://love2d.org/#download 網站] 下載最新的 LÖVE 版本並且完成安裝. 若您使用視窗操作系統但是不想''安裝'' LÖVE, 您也可...")
 
Line 11: Line 11:
 
== 建立第一個遊戲 ==
 
== 建立第一個遊戲 ==
  
To make a minimal game, create a folder anywhere, and open up your favorite code editor. Notepad++ is a pretty good one for Windows, and it has Lua support built in. Create a new file in the folder you just created, and name it <code>main.lua</code>. Put the following code in the file, and save it.
+
建立一個最基本的遊戲, 可以先在任何位置先建立一個目錄, 接著利用您常用的程式碼編輯器建立一個程式檔案. Notepad++ 是在視窗環境中一套好用的編輯器, 同時也內建 Lua 支援. 將新增的程式檔案命名為<code>main.lua</code>. 將下列程式碼放入後存檔.
  
 
<source lang="lua">
 
<source lang="lua">
Line 20: Line 20:
 
== 執行遊戲 ==
 
== 執行遊戲 ==
  
LÖVE can load a game in two ways:
+
LÖVE 載入遊戲的方法有下列兩種:
* From a folder. The startup path specifies this folder.
+
* 執行目錄中的內容. 在啟動時宣告該目錄的位置.
* From a .love file (a renamed .zip-file). The startup path specifies the file.
+
* 執行 .love 檔案 (其實是一個改名的 .zip-檔案). 在啟動時宣告該檔案的位置.
+
 
In both cases, there has to be a file called <code>main.lua</code> in the startup path or .love zipfile. This file will be loaded when LÖVE starts. If this file is missing, LÖVE will not recognize the folder or .love file as game, and it will complain about a wrongly packaged game. A frequently made mistake is zipping the folder rather than its contents. This stems from very old practice (because when you unzip a folder you don't want it to splash out all over your current directory), but for LÖVE doing that doesn't make sense: you need to zip the game folder's contents '''only''', to get a correct .love.
+
無論是哪一種方式, 都是從執行 <code>main.lua</code> 開始. LÖVE 啟動時會載入這個主檔案. 因此若所宣告的目錄或 .love 檔案中沒有這個主檔案, LÖVE 就會顯示錯誤. 常見的錯誤是只壓縮目錄而不是其內容. 這種比較老舊的做法, LÖVE 來說, 只需要 zip 目錄的內容就可得到正確的 .love 檔案.
  
 
===視窗版本===
 
===視窗版本===
  
On Windows, the easiest way to run the game is to drag the folder onto love.exe, or a shortcut to love.exe. Remember to drag the folder containing <code>main.lua</code>, and not <code>main.lua</code> itself.  
+
在視窗中, 最簡便的方式就是利用滑鼠將目錄以拖曳的方式指給 love.exe 或其捷徑. 特別注意是拖曳帶有 <code>main.lua</code> 的目錄, 而不是拖曳 <code>main.lua</code>檔案本身.  
There's also the [[Scite]] option.
+
 
 +
使用者也可以將遊戲執行設為 [[Scite]] 選項功能之一.
  
You can also call it from the command line:
+
另外一種執行方法就是利用命令列執行:
  
For instance:
+
例如:
 
<pre>
 
<pre>
 
love C:\games\mygame
 
love C:\games\mygame
Line 39: Line 40:
 
</pre>
 
</pre>
  
You can also create a shortcut to do this; simply make a shortcut to love.exe, right-click on it and select "Properties", and then put the command line you want in the "Target" box for the shortcutDouble-clicking the shortcut will execute the given command line.
+
也可以利用捷徑來進行; 直接為 love.exe 建立一個捷徑, 然後以滑鼠右鍵帶出 "Properties" , 將指令放入 "Target" 雙點擊此一捷徑後就可以執行對應的遊戲.
  
On Windows, there is a special option which will attach a console to the Window. This allows you to see standard output.
+
視窗上還有一種特別將命令列附加到視窗的做法, 這樣的執行可以看到執行的輸出結果.
  
 
<code>
 
<code>
Line 49: Line 50:
 
===Linux版本===
 
===Linux版本===
  
On Linux, you can use one of these command lines:
+
Linux 平台上, 可以利用下列指令執行:
  
 
<pre>
 
<pre>
Line 56: Line 57:
 
</pre>
 
</pre>
  
If you have installed the .deb, you can double click on .love files in your file manager as well.
+
假如已經安裝 .deb, 雙點擊 .love 檔案也可以直接執行.
  
 
===Mac OSX版本===
 
===Mac OSX版本===
  
On Mac OSX, a folder or .love file can be dropped onto the Love.app application bundle. On the Mac OSX Terminal (commandline), you can use love like this (assuming it's installed to the Applications directory):
+
Mac OSX 平台上, 遊戲目錄或 .love 可以直接拖曳給 Love.app 就可以執行. Mac OSX 命令列, 也可以利用下列指令執行:
  
 
<code>open -n -a love "/home/path/to/game"</code>
 
<code>open -n -a love "/home/path/to/game"</code>
  
In some cases it may be faster to invoke the love binary inside the application bundle directly via the following:
+
或者透過下列指令執行:
  
 
<code>/Applications/love.app/Contents/MacOS/love mygame</code>
 
<code>/Applications/love.app/Contents/MacOS/love mygame</code>

Revision as of 12:15, 13 August 2013

下載 LÖVE

網站 下載最新的 LÖVE 版本並且完成安裝. 若您使用視窗操作系統但是不想安裝 LÖVE, 您也可以下載可攜的免安裝版本, 解開壓縮後就可以使用.

您可以執行下列指令來查驗 LÖVE 的版本:

love --version

建立第一個遊戲

建立一個最基本的遊戲, 可以先在任何位置先建立一個目錄, 接著利用您常用的程式碼編輯器建立一個程式檔案. Notepad++ 是在視窗環境中一套好用的編輯器, 同時也內建 Lua 支援. 將新增的程式檔案命名為main.lua. 將下列程式碼放入後存檔.

function love.draw()
    love.graphics.print("Hello World", 400, 300)
end

執行遊戲

LÖVE 載入遊戲的方法有下列兩種:

  • 執行目錄中的內容. 在啟動時宣告該目錄的位置.
  • 執行 .love 檔案 (其實是一個改名的 .zip-檔案). 在啟動時宣告該檔案的位置.

無論是哪一種方式, 都是從執行 main.lua 開始. LÖVE 啟動時會載入這個主檔案. 因此若所宣告的目錄或 .love 檔案中沒有這個主檔案, LÖVE 就會顯示錯誤. 常見的錯誤是只壓縮目錄而不是其內容. 這種比較老舊的做法, 對 LÖVE 來說, 只需要 zip 目錄的內容就可得到正確的 .love 檔案.

視窗版本

在視窗中, 最簡便的方式就是利用滑鼠將目錄以拖曳的方式指給 love.exe 或其捷徑. 特別注意是拖曳帶有 main.lua 的目錄, 而不是拖曳 main.lua檔案本身.

使用者也可以將遊戲執行設為 Scite 選項功能之一.

另外一種執行方法就是利用命令列執行:

例如:

love C:\games\mygame
love C:\games\packagedgame.love

也可以利用捷徑來進行; 直接為 love.exe 建立一個捷徑, 然後以滑鼠右鍵帶出 "Properties" 後, 將指令放入 "Target" 區. 雙點擊此一捷徑後就可以執行對應的遊戲.

視窗上還有一種特別將命令列附加到視窗的做法, 這樣的執行可以看到執行的輸出結果.

love --console

Linux版本

在 Linux 平台上, 可以利用下列指令執行:

love /home/path/to/gamedir/
love /home/path/to/packagedgame.love

假如已經安裝 .deb, 雙點擊 .love 檔案也可以直接執行.

Mac OSX版本

在 Mac OSX 平台上, 遊戲目錄或 .love 可以直接拖曳給 Love.app 就可以執行. 在 Mac OSX 命令列, 也可以利用下列指令執行:

open -n -a love "/home/path/to/game"

或者透過下列指令執行:

/Applications/love.app/Contents/MacOS/love mygame


You can setup an alias in your Terminal session to call the binary when you use love by adding an alias to your ~/.bash_profile.

Open the file with open -a TextEdit ~/.bash_profile (you may have to run touch ~/.bash_profile first if the file does not yet exist)

Then paste in the following code and save the file:

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

Now you can call love from the commandline like Linux and Windows:

love "/home/path/to/game"


If you debug using the print command, it is useful to see this printed in realtime. In which case the following will open an extra window that will show the printed text.

xterm -e /Applications/love.app/Contents/MacOS/love "/home/path/to/game"

Note for OS X Lion Users: The above steps do not achieve the desires results under Lion. In order to run Löve and retain the print() functionality you can use a script such as the following:

#!/bin/bash
exec /Applications/love.app/Contents/MacOS/love "/home/path/to/game"


Next steps

Other Languages