~vbkaisetsu/renpy-doc/trunk : revision 20

17

"Content-Transfer-Encoding: 8bit\n"

18

19

#: ../../source/quickstart.rst:5

20

# f515e7cea1424f228ed9622ea8d63ce2

20

# 9af93aba647f4cb6b2475b5e448053d6

21

msgid "Quickstart"

22

msgstr ""

23

24

#: ../../source/quickstart.rst:7

25

# ef1a78afd1354c5eb4de0d5c54e68db2

25

# 8964b364a724420da344d592d5ade674

26

msgid "Welcome to the Ren'Py quickstart manual. The purpose of this manual is to demonstrate how you can make a Ren'Py game from scratch, in a few easy steps. We'll do this by showing how to make a simple game, *The Question*, from scratch. This manual contains a number of examples, which are included as part of the demo game."

27

msgstr ""

28

29

#: ../../source/quickstart.rst:14

30

# 317664292a4d4f249cbd590a166176f8

30

# 2cb2f286e69d46c6abf37b34dbc88b8f

31

msgid "The Ren'Py Launcher"

32

msgstr ""

33

34

#: ../../source/quickstart.rst:17

35

# 68985fc4fff443a7915dfb7a00e2dee1

35

# 8ec56d9bb11e4a1b8bd73905d491f3c9

36

msgid "Before you begin making a game, you should first take some time to learn how the Ren'Py launcher works. The launcher lets you create, manage, edit, and run Ren'Py projects."

37

msgstr ""

38

39

#: ../../source/quickstart.rst:21

40

# 504750897292469aa557e38c4e3e19cd

40

# 9662dece816244e48da696eaf4d0a089

41

msgid "**Getting Started.** To get started you'll want to `download Ren'Py <http://www.renpy.org/wiki/renpy/Download_Ren'Py>`_."

42

msgstr ""

43

44

#: ../../source/quickstart.rst:24

45

# 6dbd3c0eea834d41a93633c007edd614

45

# 310e467a87a448bebf34b9310458af4e

46

msgid "Once you've downloaded Ren'Py, you'll want to extract it. This can generally be done by right-clicking on the package file, and picking \"Extract\" if that's an option, or \"Open\" if it's not. Follow the prompts, and you'll have a working copy of Ren'Py."

47

msgstr ""

48

49

#: ../../source/quickstart.rst:31

50

# c866946cf7fe4b6689fef4f0748725ee

50

# e04ce91fc68442759bc5fb2aedf5995f

51

msgid "Please be sure you've extracted Ren'Py to its own directory or folder on disk. If you try to run it from inside a ZIP file, it won't work properly."

52

msgstr ""

53

54

#: ../../source/quickstart.rst:35

55

# dcd4b1cf53a744e19c2820f1070aa9de

55

# 91aa8ac31bde4b128094a0aa64186174

56

msgid "Once you've extracted Ren'Py, you'll need to run it."

57

msgstr ""

58

59

#: ../../source/quickstart.rst:37

60

# 6d32bd7a228b463fa388b8929acc911f

60

# 0ff04f1d784040e38be2a1f282a464e6

61

msgid "On Windows, run the ``renpy`` or ``renpy.exe`` program."

62

msgstr ""

63

64

#: ../../source/quickstart.rst:38

65

# 5b0f17df9286487dbae2e8b9a70bd662

65

# 757ae2442caf4e63a3fbcd494116d05b

66

msgid "On Mac OS X, run the ``renpy`` application."

67

msgstr ""

68

69

#: ../../source/quickstart.rst:39

70

# 1f3532029ecf4b32b9c69429519cb641

70

# 4865087674754d6a897c05234bb5fd7e

71

msgid "On Linux, run the ``renpy.sh`` script."

72

msgstr ""

73

74

#: ../../source/quickstart.rst:42

75

# e82242f9999c40b9bcd97ba27517cfa2

75

# 89c78051ca3f4fa1b882318e47efd915

76

msgid "After running this, the Ren'Py launcher should run."

77

msgstr ""

78

79

#: ../../source/quickstart.rst:44

80

# 1b4621388a17434e997c9a2dde94c87b

80

# b1012a087e2c42b587f5e1c0326ce012

81

msgid "The Ren'Py launcher has been translated to multiple languages. To change the language, choose \"preferences\" and then select the language."

82

msgstr ""

83

84

#: ../../source/quickstart.rst:50

85

# 8946699310e942f6b2713a961906f4a9

85

# 9b20b1d85cf24e389e90c65feda2d8eb

86

msgid "**Choosing and Launching a Project.** You should first see what the completed *The Question* game looks like. To do this, start the Ren'Py launcher, and choose \"The Question\" from the first screen. Choose \"Launch Project\" to start *The Question*."

87

msgstr ""

88

89

#: ../../source/quickstart.rst:55

90

# c32d173c97134dadad42beaef1574be0

90

# 4deb2fcbff564372a7ffc763e4373c1d

91

msgid "You can get back to the Ren'Py demo by doing the same thing, but choosing \"Tutorial\" instead of \"The Question\"."

92

msgstr ""

93

94

#: ../../source/quickstart.rst:58

95

# 0e92bcc5651e4087be6d9fe53532d36a

95

# 1cdb2c72b2554744a8755413e6dc7cd2

96

msgid "**Creating a new Project.** Create a new project by choosing \"Create New Project\" from the launcher. The launcher will then ask you for a project name. Since \"The Question\" is already taken, you should enter something different, like \"My Question\". The launcher will then ask you to choose a color theme for the project. It doesn't matter what you pick at this point, just choose something that appeals to you. You'll be returned to the top menu of the launcher with your new game chosen."

97

msgstr ""

98

99

#: ../../source/quickstart.rst:68

100

# 2bc100aac5a6403b85bd293a938ea39c

100

# 7fd55ebe30764c9d923d5415bb10fbaf

101

msgid "A Simple Game"

102

msgstr ""

103

104

#: ../../source/quickstart.rst:83

105

# cfe2ba7341e74349baddff307ba57988

105

# b9af5615fba542bb9644a3a520e5605c

106

msgid "This is perhaps one of the simplest Ren'Py games. It doesn't include any pictures or anything like that, but it does show a conversation between the two characters."

107

msgstr ""

108

109

#: ../../source/quickstart.rst:87

110

# 12d10196672545748a42ab96c89e0b1b

110

# 312cb2e26ab9481a85d94df61c10c899

111

msgid "To try this out, go into the launcher, select the \"My Question Project\", and choose \"script.rpy\" from under Edit File. Ren'Py may ask you to select a text editor, after which it will download the editor you select. When it finishes, script.rpy will open in an editor. Erase everything in script.rpy, as we're starting from scratch, so you don't need what's there. Copy the example above into script.rpy, and save it."

112

msgstr ""

113

114

#: ../../source/quickstart.rst:95

115

# 4a5020abe1694f71b511ce707e3e5d2b

115

# 47dc62876be44d66904bbc6ae7099a1a

116

msgid "You're now ready to run this example. Go back to the launcher, and choose \"Launch Project\". Ren'Py will start up. Notice how, without any extra work, Ren'Py has given you menus that let you load and save the game, and change various preferences. When ready, click \"Launch Project\", and play through this example game."

117

msgstr ""

118

119

#: ../../source/quickstart.rst:101

120

# 05c3e2d6574c42c9983fc769e907d18e

120

# 6d01286d70344c18b58ad9fc1501a8fc

121

msgid "This example shows some of the commonly-used Ren'Py statements."

122

msgstr ""

123

124

#: ../../source/quickstart.rst:103

125

# 48d46c691ef44e379f3ae8bc373129e9

125

# 33741de6e6504189a1f874b8164ba031

126

msgid "The first line is a label statement. The label statement is used to give a name to a place in the program. In this case, we create a label named ``start``. The start label is special, as it's where Ren'Py scripts begin running when the user clicks \"Start Game\" on the main menu."

127

msgstr ""

128

129

#: ../../source/quickstart.rst:109

130

# 1f44952ef8314802b37e12ff7414e60a

130

# edcb8b8c4f33468a923a9e801527a5ca

131

msgid "The other lines are say statements. There are two forms of the say statement. The first is a string (beginning with a double-quote, containing characters, and ending with a double-quote) on a line by itself, which is used for narration, and the thoughts of the main character. The second form consists of two strings. It's used for dialogue, with the first string being a character name and the second being what that character is saying."

132

msgstr ""

133

134

#: ../../source/quickstart.rst:117

135

# 283fac639fdd41f4a856e55efa9bcb2d

135

# 30be97ece29149a4a1d3381b78efa010

136

msgid "Note that all the say statements are indented by four spaces. This is because they are a block underneath the label statement. In Ren'Py, blocks must be indented relative to the prior statement, and all of the statements in a block must be indented by the same amount."

137

msgstr ""

138

139

#: ../../source/quickstart.rst:122

140

# 14a136608af3468cacf900f2494f8d4c

140

# 59f8dcf0a42e411db802259b55eb2632

141

msgid "When strings contain double-quote characters, those characters need to be preceded by a backslash. This is done in the last line of our example."

142

msgstr ""

143

144

#: ../../source/quickstart.rst:126

145

# 8dc1ee20b4e943f5adb4805912c182f6

145

# 36450c7e44944ddcbbd24d3a8ee8ff22

146

msgid "While this simple game isn't much to look at, it's an example of how easy it is to get something working in Ren'Py. We'll add the pictures in a little bit, but first, let's see how to declare characters."

147

msgstr ""

148

149

#: ../../source/quickstart.rst:131

150

# 60b9ce0ae9834b45a516c4691e562ede

150

# ab6e9c7ade1e43eb9fdf5cefd1ba9690

151

msgid "Init"

152

msgstr ""

153

154

#: ../../source/quickstart.rst:133

155

# 99a7cac615de491599256d939ccf5e65

155

# 1c62ca86eec24ce7aded7281252732f2

156

msgid "The init statement is used to execute blocks of Ren'Py statements before the script executes. Init blocks are used to define images and characters, to set up unchanging game data structures, and to customize Ren'Py. Code inside init blocks should not interact with the user or change any of the layers, and so should not contain say, menu, scene, show, or hide statements, as well as calls to any function that can do these things."

157

msgstr ""

158

159

#: ../../source/quickstart.rst:140

160

# 15004fb7603c40b88c1953faf5795ea1

160

# 2f4bf3a1b5084f39a5e3b0c564c8107f

161

msgid "An init statement is introduced with the keyword init, followed by an optional priority number, and a mandatory colon. If the priority is not given, it defaults to 0. Priority numbers should be in the range -999 to 999. Numbers outside of this range are reserved for Ren'Py code."

162

msgstr ""

163

164

#: ../../source/quickstart.rst:145

165

# c5198acb17ec4e12b14c5bd85b165875

165

# 13331321c493439da4abbffb1f260f63

166

msgid "The priority number is used to determine when the code inside the init block executes. Init blocks are executed in priority order from low to high. Within a file, init blocks with the same priority are run in order from the top of the file to the bottom. The order of evaluation of priority blocks with the same priority between files is undefined."

167

msgstr ""

168

169

#: ../../source/quickstart.rst:151

170

# 0f77f4a703c84274815e9d6d02ea4a0b

170

# 947db382fff6430f9ebcf03615055f7e

171

msgid "The init blocks are all run once, during a special init phase. When control reaches the end of an init block during normal execution, execution of that block ends. If an init statement is encountered during normal execution, the init block is not run. Instead, control passes to the next statement."

172

msgstr ""

173

174

#: ../../source/quickstart.rst:157

175

# 16b1d8f25cb24ff58a9778fb1940172b

175

# 60e9a0d8013643f0ac38b77916944eae

176

msgid "Characters"

177

msgstr ""

178

179

#: ../../source/quickstart.rst:159

180

# c4ef01bdad4f42f9900221ba90b692ab

180

# f3a2675f19544f33aa5d81cb1db890af

181

msgid "One problem with the first example is that it requires you to repeatedly type the name of a character each time they speak. In a dialogue-heavy game, this might be a lot of typing. Also, both character names are displayed in the same way, in fairly boring white text. To fix this, Ren'Py lets you define characters in advance. This lets you associate a short name with a character, and to change the color of the character's name."

182

msgstr ""

183

184

#: ../../source/quickstart.rst:184

185

# 38db211e43cb4cf8906ffa6a6e56b187

185

# 5cd8e4f6b2ff4e4f950380c7df8188c0

186

msgid "The first and and second lines define characters. The first line defines a character with the short name of \"s\", the long name \"Sylvie\", with a name that is shown in a greenish color. (The colors are red-green-blue hex triples, as used in web pages.)"

187

msgstr ""

188

189

#: ../../source/quickstart.rst:189

190

# 542555a9bd0f4d1892098f49072f48bc

190

# 4857b6d99ae248e79c97665e01633e0d

191

msgid "The second line creates a character with a short name \"m\", a long name \"Me\", with the name shown in a reddish color. Other characters can be defined by copying one of the character lines, and changing the short name, long name, and color."

192

msgstr ""

193

194

#: ../../source/quickstart.rst:194

195

# 1a897fd611514094a3a08b2da072aa65

195

# 67f65f76b4d94e00b7410609b753354b

196

msgid "We've also changed the say statements to use character objects instead of a character name string. This tells Ren'Py to use the characters we defined in the init block."

197

msgstr ""

198

199

#: ../../source/quickstart.rst:199

200

# ba2138dd8f4747d194b495b281c072c7

200

# df4bf2c6bb0645a886d39a942a5680e3

201

msgid "Images"

202

msgstr ""

203

204

#: ../../source/quickstart.rst:201

205

# 01584e1baddc4590ac04925592291373

205

# a4492e2f104e475999ef3fcac79c4132

206

msgid "A visual novel isn't much of a visual novel without pictures. Let's add some pictures to our game."

207

msgstr ""

208

209

#: ../../source/quickstart.rst:234

210

# 18a36f56529440c58d97e0c6625d82e4

210

# 5519a32d13764b009f7320f1e51ad78c

211

msgid "The first new thing we needed to do was to declare the images, using image statements on lines 2, 3, 5, and 6, inside the init block. These image statements give an image name, and the filename the image is found in."

212

msgstr ""

213

214

#: ../../source/quickstart.rst:239

215

# 87e61ce097c5484d894ee1a0c7523c28

215

# 7f7eac6608624871bb543d655246da34

216

msgid "For example, line 5 declares an image named \"sylvie smile\", found in the filename \"sylvie_smile.png\", with the tag \"sylvie\"."

217

msgstr ""

218

219

#: ../../source/quickstart.rst:242

220

# 418c50362c72400d83ce16b90793d180

220

# f1b3a0eac26940d9b0c5728c27c1f40a

221

msgid "We have a scene statement on line 12. This statement clears out the screen, and shows the \"bg meadow\" image. The next line is a show statement, which shows the \"sylvie smile\" image on the screen."

222

msgstr ""

223

224

#: ../../source/quickstart.rst:246

225

# 893270ab35ba4311a42e97127209d018

225

# 045fde5b70794de2a78ce37da70b1482

226

msgid "The first part of an image name is the image tag. If an image is being shown, and another image with the same tag is on the screen, then the image that's on the screen is replaced with the one being shown. This happens on line 19, the second show statement. Before line 19 is run, the image \"sylvie smile\" is on the screen. When line 19 is run, that image is replaces with \"sylvie surprised\", since they share the \"sylvie\" tag."

227

msgstr ""

228

229

#: ../../source/quickstart.rst:254

230

# dd2c989d7f3b46bbb3b9b9363e97b9dc

230

# a1f234c9f728409a9337f608e4cd2e5d

231

msgid "For Ren'Py to find the image files, they need to be placed in the game directory of the current project. The game directory can be found at \"`Project-Name`/game/\", or by clicking the \"Game Directory\" button in the launcher. You'll probably want to copy the image files from the \"the_question/game/\" directory into the \"my_question/game/\" directory, so you can run this example."

232

msgstr ""

233

234

#: ../../source/quickstart.rst:261

235

# 781c0b9fbfa84c359a90833d3f22436f

235

# c63059750c9d498187177aa5e92fb61f

236

msgid "Ren'Py does not make any distinction between character and background art, as they're both treated as images. In general, character art needs to be transparent, which means it should be a PNG file. Background art can be JPEG or PNG files. By convention, background images start with the \"bg\" tag."

237

msgstr ""

238

239

#: ../../source/quickstart.rst:267

240

# 4912af79b8e0445f8c2583fe488d51a4

240

# c36df8c6e4e84910aab4646f2bcbb55a

241

msgid "**Hide Statement.** Ren'Py also supports a hide statement, which hides the given image."

242

msgstr ""

243

244

#: ../../source/quickstart.rst:282

245

# ecd051dd242b45b9869c0bbad2919320

245

# a19ff66a0cc64134b69bd5f2667b1b77

246

msgid "It's actually pretty rare that you'll need to use hide. Show can be used when a character is changing emotions, while scene is used when everyone leaves. You only need to use hide when a character leaves and the scene stays the same."

247

msgstr ""

248

249

#: ../../source/quickstart.rst:288

250

# 9a32e124c78d424eb3a4eb2f2c5714cc

250

# ae9d6a4dbdfc455da92cd45d5fa5476b

251

msgid "Transitions"

252

msgstr ""

253

254

#: ../../source/quickstart.rst:290

255

# 4686b93e4fcd4400b8ca59624e8eb668

255

# cac464625c254a96a08a83928f91ec16

256

msgid "Simply having pictures pop in and out is boring, so Ren'Py implements transitions that can make changes to the screen more interesting. Transitions change the screen from what it looked like at the end of the last interaction (dialogue, menu, or transition), to what it looks like after any scene, show, and hide statements."

257

msgstr ""

258

259

#: ../../source/quickstart.rst:322

260

# b1e698f921af4eb78218c027c88906a2

260

# 192b258f3cf74d3e894a6e1f5978708a

261

msgid "The with statement takes the name of a transition to use. The most common one is ``dissolve`` which dissolves from one screen to the next. Another useful transition is ``fade`` which fades the screen to black, and then fades in the new screen."

262

msgstr ""

263

264

#: ../../source/quickstart.rst:327

265

# 619af86326514cc8a7dc3128f17189ae

265

# 99b0323af00a476d9b75de061c85b786

266

msgid "When a transition is placed after multiple scene, show, or hide statements, it applies to them all at once. If you were to write::"

267

msgstr ""

268

269

#: ../../source/quickstart.rst:335

270

# 5006069c5cbd4a148ee6eedaa9dceba1

270

# be7af2da92d44ad993c707987085e145

271

msgid "Both the \"bg meadow\" and \"sylvie smiles\" would be dissolved in at the same time. To dissolve them in one at a time, you need to write two with statements::"

272

msgstr ""

273

274

#: ../../source/quickstart.rst:345

275

# 925253c6726d40f1959fca37aae09607

275

# ee4a557aea84490f92563e69e403f4ed

276

msgid "This first dissolves in the meadow, and then dissolves in sylvie. If you wanted to instantly show the meadow, and then show sylvie, you could write::"

277

msgstr ""

278

279

#: ../../source/quickstart.rst:355

280

# 245f6994f8a04403bb581a9ad039673c

280

# 2a205be394894e15adbe72cebcab82a1

281

msgid "Here, None is used to indicate a special transition that updates Ren'Py's idea of what the prior screen was, without actually showing anything to the user."

282

msgstr ""

283

284

#: ../../source/quickstart.rst:360

285

# 3338d79bf39e46b8bf952cd2692b51f4

285

# dbd98652056d412a983fe7408668dffb

286

msgid "Positions"

287

msgstr ""

288

289

#: ../../source/quickstart.rst:362

290

# e805583a8cce434b8a5db4daae4f4db8

290

# a60dcbee37324a10bcaaecc4485985c1

291

msgid "By default, images are shown centered horizontally, and with their bottom edge touching the bottom of the screen. This is usually okay for backgrounds and single characters, but when showing more than one character on the screen it probably makes sense to do it at another position. It also might make sense to reposition a character for story purposes."

292

msgstr ""

293

294

#: ../../source/quickstart.rst:374

295

# dee38e1ab8b04ae99b905b29da82326b

295

# e8a04417e7f246e4a26afa751543720b

296

msgid "To do this repositioning, add an at-clause to a show statement. The at clause takes a position, and shows the image at that position. Ren'Py includes several pre-defined positions: ``left`` for the right side of the screen, ``right`` for the right side, ``center`` for centered horizontally (the default), and ``truecenter`` for centered horizontally and vertically."

297

msgstr ""

298

299

#: ../../source/quickstart.rst:381

300

# d50a697e54d54477bffb368530de6b64

300

# a4ee7230cc794e5d898c68fe8b00ea08

301

msgid "A user can define their own positions, and event complicated moves, but that's outside of the scope of this quickstart."

302

msgstr ""

303

304

#: ../../source/quickstart.rst:385

305

# 3a2ad42748574ca3b4e73a2266156f47

305

# b5d9598971c044d7bbc478a9f2909045

306

msgid "Music and Sound"

307

msgstr ""

308

309

#: ../../source/quickstart.rst:387

310

# f985e5b575cb41108a9c865906dab3e2

310

# 556a923c2a4f454785e1821b8ccc3e14

311

msgid "Most games play music in the background. Music is played with the play music statement. It can take either a string containing a filename, or a list of filenames to be played. When the list is given, the item of it is played in order. ::"

312

msgstr ""

313

314

#: ../../source/quickstart.rst:396

315

# 929b3c8c542e42b3ac45dc0cd9ae465f

315

# 4ec68f5de67641aa8116092e4d0da3b1

316

msgid "When changing music, one can supply a fadeout and a fadein clause, which are used to fade out the old music and fade in the new music. ::"

317

msgstr ""

318

319

#: ../../source/quickstart.rst:402

320

# 3cf0e1842ff5414a89bd6017885850b2

320

# 6c49da6dc93e49bb969d2070b3230280

321

msgid "And if you supply a loop clause, it loops. if you supply a noloop clause, it doesn't loop. In Ren'Py, music files automatically loop until they are stopped by the user. ::"

322

msgstr ""

323

324

#: ../../source/quickstart.rst:410

325

# 93f7b98f7d5949ce9402f9a0b1451872

325

# 60affe14ba8440b5872fc388216a7100

326

msgid "Music can be stopped with the stop music statement, which can also optionally take a fadeout clause. ::"

327

msgstr ""

328

329

#: ../../source/quickstart.rst:416

330

# 6f624d89cace4299bad247e2c83e3c53

330

# 8472600f33b3400284e5e633d4008b68

331

msgid "Sound effects can be played with the play sound statement. It defaults to not looping. ::"

332

msgstr ""

333

334

#: ../../source/quickstart.rst:421

335

# febeb03b40804b17ae94d222d97492db

335

# f003e960c3584871a8cbc6df89322066

336

msgid "The play sound statement can have same clauses with the play music statement."

337

msgstr ""

338

339

#: ../../source/quickstart.rst:423

340

# f489f00b3fb74dffa6d7b063988e8ce8

340

# 1e7602895c5a4166b6936b58f70aa49e

341

msgid "Ren'Py support many formats for sound and music, but OGG Vorbis is preferred. Like image files, sound and music files must be placed in the game directory."

342

msgstr ""

343

344

#: ../../source/quickstart.rst:428

345

# 8762e5c4eda141cbac86f52a098628be

345

# 6d06ebfd52214e0ab98dbc7cc30db733

346

msgid "Pause Statement"

347

msgstr ""

348

349

#: ../../source/quickstart.rst:430

350

# 8fed83ddcb474d9781a34f3ba35b3d75

350

# 78ae7f7618264c06b2e1753548df7727

351

msgid "The pause statement causes Ren'Py to pause until the mouse is clicked. If the optional expression is given, it will be evaluated to a number, and the pause will automatically terminate once that number of seconds has elapsed."

352

msgstr ""

353

354

#: ../../source/quickstart.rst:435

355

# 786238a793204aa385160250a3e71329

355

# cdb46d1e41a74ab9a9109226a1c0980a

356

msgid "Ending the Game"

357

msgstr ""

358

359

#: ../../source/quickstart.rst:437

360

# 0e5d2bdcc5be454d911b24d514a4aa22

360

# c7650ad76d674a4b8fd756c0483fa15e

361

msgid "You can end the game by running the return statement, without having called anything. Before doing this, it's best to put something in the game that indicates that the game is ending, and perhaps giving the user an ending number or ending name. ::"

362

msgstr ""

363

364

#: ../../source/quickstart.rst:447

365

# ff8ab607547e452eb97cca7032a30d1c

365

# 73bfe060adeb483c9fe1fd5604663981

366

msgid "That's all you need to make a kinetic novel, a game without any choices in it. Now, we'll look at what it takes to make a game that presents menus to the user."

367

msgstr ""

368

369

#: ../../source/quickstart.rst:452

370

# 0c22858cad664370ba78dc4ad35cb819

370

# cc786ddcdc2c44f88d814820e3e05175

371

msgid "Menus, Labels, and Jumps"

372

msgstr ""

373

374

#: ../../source/quickstart.rst:454

375

# cbfe01773f9041d4a416f446b502a8bb

375

# e1154f06a4b0429dbf9a00cfec79f9ac

376

msgid "The menu statement lets you present a choice to the user::"

377

msgstr ""

378

379

#: ../../source/quickstart.rst:480

380

# f3293a1f4fa34ec880304d94ec192c49

380

# 2418f19afbd04978895ed7b5e7f9e2c5

381

msgid "This example shows how menus are used with Ren'Py. The menu statement introduces an in-game-menu. The menu statement takes a block of lines, each consisting of a string followed by a colon. These are the menu choices which are presented to the user. Each menu choice should be followed by a block of one or more Ren'Py statements. When a choice is chosen, the statements following it are run."

382

msgstr ""

383

384

#: ../../source/quickstart.rst:487

385

# fa3f379df996411087d4fe904940bdd2

385

# 3664b49effd14abfae46daf0ede4a319

386

msgid "In our example, each menu choice runs a jump statement. The jump statement transfers control to a label defined using the label statement. The code following that label is run."

387

msgstr ""

388

389

#: ../../source/quickstart.rst:491

390

# 30dfd20b543c423a8cb3ce28f41dce66

390

# 739413f0caf1440e957914b0342ca23b

391

msgid "In our example above, after Sylvie asks her question, the user is presented with a menu containing two choices. If the user picks \"It's a story with pictures.\", the first jump statement is run, and control is transferred to the ``vn`` label. This will cause the pov character to say \"It's a story with pictures and music.\", after which control is transferred to the ``marry`` label."

392

msgstr ""

393

394

#: ../../source/quickstart.rst:498

395

# 259778e342e045979be17d7e063b2f7f

395

# a43ce4cbc553479a96d6473886219d25

396

msgid "Labels may be defined in any file that is in the game directory, and ends with .rpy. The filename doesn't matter to Ren'Py, only the labels contained within it. A label may only appear in a single file."

397

msgstr ""

398

399

#: ../../source/quickstart.rst:503

400

# 20a35a09ea0e482391fa68e7bd9106bf

400

# ef00f8b8e9414e969fb0f4bb958e27c8

401

msgid "Python and If Statements"

402

msgstr ""

403

404

#: ../../source/quickstart.rst:505

405

# ae77eb5ec581401aaf20283d5ede79e2

405

# 55a858f6ffc34b07858b5741435e9ddc

406

msgid "While simple (and even fairly complex) games can be made using only using menus and jump statements, after a point it becomes necessary to store the user's choices in variables, and access them again later. This is what Ren'Py's python support is for."

407

msgstr ""

408

409

#: ../../source/quickstart.rst:510

410

# c3699c4b4ca24365a300fad24667cbbc

410

# b48c4278d6a24163a8eff4b877c55eab

411

msgid "Python support can be accessed in two ways. A line beginning with a dollar-sign is a single-line python statement, while the keyword \"python:\" is used to introduce a block of python statements."

412

msgstr ""

413

414

#: ../../source/quickstart.rst:514

415

# e743689e263243d2941f7562000a340d

415

# c5d3160556694a799f983784471ae134

416

msgid "Python makes it easy to store flags in response to user input. Just initialize the flag at the start of the game::"

417

msgstr ""

418

419

#: ../../source/quickstart.rst:520

420

# f2ed9eb77d9c44f998375dc80e316fc2

420

# 3eec923a133441eb9bbffb0a3f3ca3cf

421

msgid "You can then change the flag in code that is chosen by menus::"

422

msgstr ""

423

424

#: ../../source/quickstart.rst:533

425

# 6bb7b8e54092487c80cfa122bff1b5af

425

# 416614a367e6495e80d9922266043152

426

msgid "And check it later::"

427

msgstr ""

428

429

#: ../../source/quickstart.rst:543

430

# c086773549774c9b825b75316696ae6f

430

# 39fa8ebb101c4e0080ca13ce9c6ebd49

431

msgid "Of course, python variables need not be simple True/False values. They can be arbitrary python values. They can be used to store the player's name, to store a points score, or for any other purpose. Since Ren'Py includes the ability to use the full Python programming language, many things are possible."

432

msgstr ""

433

434

#: ../../source/quickstart.rst:550

435

# e84278ccba1d400ebcd7e9825747631e

435

# 2ac44d9149ab4c9a9e8971cf341302c1

436

msgid "Releasing Your Game"

437

msgstr ""

438

439

#: ../../source/quickstart.rst:552

440

# 9ed97156318641e18b4f77c64e1ab408

440

# bcc02b963b354869842af9b7eb0dae5e

441

msgid "Once you've made a game, there are a number of things you should do before releasing it:"

442

msgstr ""

443

444

#: ../../source/quickstart.rst:560

445

# 54aacb61fac147ac865d250a641f75ce

445

# c64969b480e6447fba006cec1f569d63

446

msgid "**Edit options.rpy.**"

447

msgstr ""

448

449

#: ../../source/quickstart.rst:556

450

# 59fd0486537c45469a334c62cdeb0847

450

# 5aedc43f87d14a9580cb81e2e9328834

451

msgid "The options.rpy file, created when you create a new game, contains a number of settings that you may want to customize. Some of them, like the screen height and screen width, should probably be set before making the game. Others, like the window title, can be set any time."

452

msgstr ""

453

454

#: ../../source/quickstart.rst:570

455

# 451fefb30dd045239106ab64252542f7

455

# 4ba192ccdebf43ffa938ca5a5326d52c

456

msgid "**Add a plug for Ren'Py.**"

457

msgstr ""

458

459

#: ../../source/quickstart.rst:563

460

# 8276d66f9569432cb6b1bf90a078f430

460

# e07e32c47d5b4eb380b806d8e36a65e5

461

msgid "This step is completely optional, but we do ask that if you have credits in your game, you mention Ren'Py in them. We suggest using something like \"Made with the Ren'Py visual novel engine.\", but that's just a suggestion, and what you write is up to you."

462

msgstr ""

463

464

#: ../../source/quickstart.rst:568

465

# 21ec5a4bd7d143b09abc00eb4c655e9c

465

# eafa840b5d974308b15b03d94abc9c2b

466

msgid "We think that the games people make are the best advertising for Ren'Py, and we hope that by including this, you'll help more people learn how to make visual novels in Ren'Py."

467

msgstr ""

468

469

#: ../../source/quickstart.rst:577

470

# cad1e36b66884555a9035842a33552f4

470

# f9bd966ec0064a959c6e0fe713a30ea7

471

msgid "**Check for a new version of Ren'Py.**"

472

msgstr ""

473

474

#: ../../source/quickstart.rst:573

475

# 4e0aee4554e24ce9a2a0efd2a80dbd7d

475

# 3369c0fd7a1846b6b3447ca988d40482

476

msgid "New versions of Ren'Py are released on a regular basis, to fix bugs and add new features. Before releasing, click update in the launcher to update Ren'Py to the latest version. You can also download new versions and view a list of changes at `http://www.renpy.org/latest.html <http://www.renpy.org/latest.html>`_."

477

msgstr ""

478

479

#: ../../source/quickstart.rst:584

480

# 7701dd5b06be43868e566647fa2c3fcb

480

# 9758ae26876e41718d0bb0e1ed400e5d

481

msgid "**Check the Script.**"

482

msgstr ""

483

484

#: ../../source/quickstart.rst:580

485

# ed94d767e8c941bd8105862b4aac12c3

485

# 0b4f4372b0bf4fca82e4c04294cbcd3b

486

msgid "From the front page of the launcher, choose \"Check Script (Lint)\". This will check your games for errors that may affect some users. These errors can affect users on the Mac and Linux platforms, so it's important to fix them all, even if you don't see them on your computer."

487

msgstr ""

488

489

#: ../../source/quickstart.rst:589

490

# 5d50deac201b4a4593e82afecc6cd3c6

490

# ce19e6a3d642454c80d1cfde96a198b6

491

msgid "**Build Distributions.**"

492

msgstr ""

493

494

#: ../../source/quickstart.rst:587

495

# 4c0f6b9d3b574cd09d4bf26e698a0f12

495

# e59e7add4b42477a95058b98e6f03ec8

496

msgid "From the front page of the launcher, choose \"Build Distributions\". Based on the information contained in options.rpy, the launcher will build one or more archive files containing your game."

497

msgstr ""

498

499

#: ../../source/quickstart.rst:595

500

# b4aa604a347c466a86bdb6639e0896eb

500

# aac90b1616f34a57be44cc7f2afb4b7a

501

msgid "**Test.**"

502

msgstr ""

503

504

#: ../../source/quickstart.rst:592

505

# 49b4dd754ac64d3888262240484e31a6

505

# 9fdd4a1fe7c6430bb46e1cf29968f8a0

506

msgid "Lint is not a substitute for thorough testing. It's your responsibility to check your game before it is released. Consider asking friends to help beta-test your game, as often a tester can find problems you can't."

507

msgstr ""

508

509

#: ../../source/quickstart.rst:603

510

# d695b348adda4ebeb70c03775f71ce5a

510

# 3e21ed21758345d3bb23bbf41b02a4a8

511

msgid "**Release.**"

512

msgstr ""

513

514

#: ../../source/quickstart.rst:598

515

# d643de0e70844bbb968bd23576ddee49

515

# 921f887848a347869060f9d2d611c967

516

msgid "You should post the generated files (for Windows, Mac, and Linux) up on the web somewhere, and tell people where to download them from. Congratulations, you've released a game!"

517

msgstr ""

518

519

#: ../../source/quickstart.rst:602

520

# 7d1c7bba75c247bea2766c129f8f970e

520

# 513969736a0a407a89a4067d158c9316

521

msgid "Please also add your released game to our `games database <http://games.renpy.org>`_, so we can keep track of the Ren'Py games being made."

522

msgstr ""

523

524

#: ../../source/quickstart.rst:606

525

# 84aa7d4b949c435ba2431b7d7f53c973

525

# 2a15de6c52b941498f5d8acc671990d2

526

msgid "Script of The Question"

527

msgstr ""

528

529

#: ../../source/quickstart.rst:608

530

# f7b74324e3744af9b627d01c08a2cf2a

530

# 6e55c41d866840b1aa0ec8a0a518ad77

531

msgid "You can view the full script of ''The Question'' :ref:`here <thequestion>`."

532

msgstr ""

533

534

#: ../../source/quickstart.rst:611

535

# 129973afd3924391b8dd1ebcf419e9a0

535

# 2e9afbcdcfc046448e83d5a13094d396

536

msgid "Where do we go from here?"

537

msgstr ""

538

539

#: ../../source/quickstart.rst:613

540

# 8a05120cdc0d48dcad31aaf9b817b0c7

540

# f84b6cdf154b496f862b433fd92403d4

541

msgid "This Quickstart has barely scratched the surface of what Ren'Py is capable of. For simplicity's sake, we've omitted many features Ren'Py supports. To get a feel for what Ren'Py is capable of, we suggest playing through the Tutorial, and having Eileen demonstrate these features to you."

542

msgstr ""

543

544

#: ../../source/quickstart.rst:619

545

# acf1ae98971343b78e804724dfaee6c9

545

# d46b97222be1435184977f07db74aec1

546

msgid "You may also want to read the rest of this (complex) manual, as it's the definitive guide to Ren'Py."

547

msgstr ""

548

549

#: ../../source/quickstart.rst:622

550

# 16c2221d339648859236adace485fba0

550

# 6db5d3b6cb4f49f087997bfa24fbc878

551

msgid "On the Ren'Py website, there's the a `FAQ <http://www.renpy.org/wiki/renpy/doc/FAQ>`_ giving answers to common questions, and a `Cookbook <http://www.renpy.org/wiki/renpy/doc/cookbook/Cookbook>`_ giving useful code snippets. If you have questions, we suggest asking them at the `Lemma Soft Forums <http://lemmasoft.renai.us/forums/>`_, the official forum of Ren'Py. This is the central hub of the Ren'Py community, where we welcome new users and the questions they bring."

552

msgstr ""

553

554

#: ../../source/quickstart.rst:629

555

# 2f9ccc55288c4775b2302b579aec19f5

555

# 10d239cd5fa143e6bd34ea2cbaa25641

556

msgid "Thank you for choosing the Ren'Py visual novel engine. We look forward to seeing what you create with it!"

557

msgstr ""

558