User guide for Ark, short for Ryzom Arkitect.
For historical reasons, those manuals refers very often, almost always, to A.R.C.C.. This is due to the fact that the full documentation has been started with the initial name, ARCC, meaning Advanced Ryzom Content Creator.
This guide aims at explaining how to use Ark, the Ryzom Arkitect tool that allows the creation of scripts interpreted by a web server and interacting with Ryzom's server.
((~This is going to have to be changed because of the selection panel that Ulukyn has made which is divided into different areas of the basic tree structure~)) As soon as login on, use finds a page offering access to various areas of the ARCC.
|The root directory appears as a small «house» icon. The «house» is the first folder, the one that contains all other elements, events and folders.|
|Generally, folders are represented with classical icons for folders (the last two ones in the example shown here above). Some important folders are given a specific icon.|
|Events are represented with the icon shown on the left.|
Zone 1 shows the place of the event in the folders tree. Each clickable link allows you to go to the specified folder (but remember to save your progress first).
Zone 2 allows you to create a new script or a new database.
Zone 3 contains two tools:
((This link does not yet point to anything substantial - Ceru 25 Sept 2014.))
|How to do automated translations|
Zone 4 contains the scripts created in the event shown in zone 1 (here «New Event»).
The bottom part contains the meaning of the colored bullets appended to the scripts.
The middle part contains the list of the scripts associated to the event.
To each script is associated a set of indicators and actions, listed here bellow as they appear from left to right. (to be checked with the English version of the screenshots)
|A simple script|
|A linked script, meaning assigned to a NPC|
|Zone 5 shows the list of the databases of the event.|
Eack clickable link allows to go to the intended folder.
The quickest and least wearying method to create a script is to copy it from another one ressembling to what we want to produce. This method is very useful to create quickly a script that looks like another one, but you'll have to learn how to modify it sooner or later... otherwise, of which use would it be to have two script identical except for their names? That will be explaned in part II of the this user guide for ARCC.
Fill the new script.
Replay sequences 6 to 8 with «Script1»
Then, click in the already existing text (to place the focus) and select it all (for example: by hitting <Ctrl>+A on Windows and Unices) to replace it with the text saved in the clipboard (for example, by hitting <Ctrl>+V). Once the text has been replaced, save it:
Once this function has been activated, the database shows a content like this one.
Here you have a filling of databases with different context.
|You can start by testing the script in the browser by clicking on (1) in the browser.|
It allows to test most or the script proceedings, especially the part about algorithms and displays. Be aware nonetheless to the display which doesn't necessarily appear exactly the same way in the Web and in the WebIG. Indeed some html tags doesn't pass through the last one. For example the <hr/> tag (horizontal rule) doesn't appear in the WebIg, and neither does <br/> (line break). That's why it's better to use bbcode.
To conclude, launching a script in a browser shouldn't be used to check the appearance of a display.
|If a problem appears during the execution, it may be useful to test the proceedings. In this case, click on (2). The following image shows the result for the current example:|
|either simply by clicking on the progess icon,|
|or by selecting the proposed choice when there is a multiple connection.|
To test the script life-size, it has to be lauchned on the test server known under the name of «Yubo». For this, connect on the «Yubo» with an authorized account, choose preferabily a static NPC (so that you don't have to run behind him for the tests) and, of course, a free one (don't re-use a mission NPC so that you don't get unexpected complications).
|Using the source code has been seen (5) in chapter 4, when copying/pasting the content of a script into another one.|
|When update fails, it is always possible to come back to a former version by clicking on (6).|
|then by adding,|
|and of course, by modifiant the content of the functions themselves (here: « weVMessage_v3_True ») which will be seen in Part II.|
|Active on Atys and Yubo|
|Working and locked|
|Deactivated (to be removed)|
|Run the script.|
|See and edit the script both in human and machine language.|
|See and edit the access and running rights.|
|Show who is using the script.|
|Ask for the script deletion.|
|Deletion of the script.|
63 pages in ARCC