Changes between Version 22 and Version 23 of ITERATION_12/Release/UserDocumentation/AnIntroductionToSophie/AnIntroductionToSophieServer
- Timestamp:
- 05/05/10 18:23:11 (15 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
ITERATION_12/Release/UserDocumentation/AnIntroductionToSophie/AnIntroductionToSophieServer
v22 v23 21 21 [[Image(source:/trunk/sophie2-platform/doc/app-help/images/SophieServerHomePage.png)]] 22 22 23 From this home page, you can browse any books that are currently on your Sophie Server by clicking the '''Browse''' link. We're going to assume that since you just started Sophie Server, you probably haven't saved anything on it. If you have an account, you can login, using the '''Login''' link; probably you don't. So the first thing to do is to click '''Register''' to register for an account on Sophie Server. You'll be taken to the registration page, which looks like this: 23 From this home page, you can browse any books that are currently on your Sophie Server by clicking the '''Browse''' link. We're going to assume that since you just started Sophie Server, you probably haven't saved anything on it. If you have an account, you can login, using the '''Login''' link; probably you don't. In that case, you need to register for an account on Sophie Server. 24 25 == Registering for an account on Sophie Server == 26 27 The first thing to do is to click '''Register''' to register for an account on Sophie Server. You'll be taken to the registration page, which looks like this: 24 28 25 29 [[Image(source:/trunk/sophie2-platform/doc/app-help/images/SophieServerRegistrationPag.png)]] 26 30 31 Enter a username, your email, and a password twice; you can also fill out the other fields (and upload an icon for yourself) if you want. Registration needs to be done for everyone who wants to use Sophie Server. While it's possible to access Sophie Server anonymously, registering connects your name with the books you're using. Once you've registered, an '''Edit Profile''' link appears that will let you change your details or your password. 32 27 33 == Saving books to Sophie Server == 28 34 29 To use Sophie, after starting it up you'll need to start either Sophie Author or Sophie Reader. In both, the interface is very similar. Sophie Author allows you to save and load books to Sophie Server; Sophie Reader only allows you to read books on Sophie Server. For the purposes of this demo, we'll use Sophie Author. 30 31 After you've started Sophie Server, you need to connect to Sophie Server. To do this: 35 You can upload books directly to Sophie Server by clicking '''Browse''' in the menu, then clicking '''Choose File''', selecting a ''.book.s2'' file on your computer, and clicking '''Upload'''. But generally it makes more sense to upload books from inside of Sophie Author. Start up Sophie Author. Once it's ready, let's connect to Sophie Server. To do this: 32 36 33 37 1. Go to the '''Servers''' tab in the left flap. This interface is how you connect to Sophie Server. The top palette shows a list of Sophie Servers you can connect to; the bottom palette shows all the resources that are on the currently selected servers. … … 35 39 3. The URL for your own computer is ''http://127.0.0.1:8003'' or ''http://localhost:8003''. Enter one of these as the URL. The '':8003'' is very important: that means that Sophie Server uses port 8003 on your computer, and all Sophie Server addresses will end with this. 36 40 4. The URL should now appear in the list in the top palette of the servers tab. You have not yet connected to the server; you've just added it to the list of Sophie Servers you could connect to. To connect to the server, first select it in the list. Then click the '''Connect''' button at the bottom of the palette. 41 5. Now you'll be asked for a username and password. Enter the username and password that you gave Sophie Server when you registered on the website. (You can also use the username "Anonymous" and no password to log in to your Sophie Server anonymously.) 37 42 5. If everything's working, you should see a message that says '''Successfully Connected.''' Click '''Okay''' to make this message go away. 38 43 39 Now you're connected to Sophie Server. But there's probably nothing on your Sophie Server. So let's make a book and save it on Sophie Server. Create a new book; it doesn't matter what's in it, though make sure that it has two pages. Now let's save your book to the server.44 Now you're connected to Sophie Server. The palette below the list of servers, called '''Server Resources''' will show all the books that are currently on your Sophie Server. There's probably nothing on your Sophie Server yet. So let's make a book and save it on Sophie Server. Create a new book; it doesn't matter what's in it, though make sure that it has two pages. Now let's save your book to the server. 40 45 41 46 1. Choose '''File > Save On Server''' from the file menus. A dialogue box will come up. 42 2. Choose '' http://127.0.0.1:8003''from the list of Sophie Servers to save it to your own Sophie Server. Sophie lets you connect to several Sophie Servers at once; that's why you need to select a Sophie Server.47 2. Choose ''username@localhost:8003'' (where ''username'' is the username that you used) from the list of Sophie Servers to save it to your own Sophie Server. Sophie lets you connect to several Sophie Servers at once; that's why you need to select a Sophie Server. 43 48 3. If you want to change your book's name, you can edit it in the ''Resource Path:'' field. You don't have to. 44 49 4. Underneath the ''Resource Path:'' field, there's a checkbox marked '''Start Editing on Server'''. If this is checked, after you click '''Okay''', you'll be editing the book on the server. If you don't, you'll simply be saving a copy of your book to the server; you'll still be working with the local copy. Make sure this is checked. 45 50 5. Click '''Okay''' to save your book on Sophie Server. 46 51 47 That's it. Now your book is on Sophie Server; any changes that you make will be saved to Sophie Server as well . (You can use '''File > Save As''' to save a copy of your book locally, if you want.) Your book should now be listed in the '''Resources''' palette in the servers tab; if it's not, try clicking in the palettes a few times to make them refresh.52 That's it. Now your book is on Sophie Server; any changes that you make will be saved to Sophie Server as well; you don't need to actually save anymore. (You can use '''File > Save As''' to save a copy of your book locally, if you want.) Your book should now be listed in the '''Resources''' palette in the servers tab; if it's not, try clicking in the palettes a few times to make them refresh. 48 53 49 54 == Reading books on Sophie Server == … … 61 66 1. Find out the [http://www.whatismyip.com/ IP address] of the computer running Sophie Server. 62 67 2. On the second computer, add the server. If the IP address you just found out is ''208.120.76.86'', for example, enter ''http://208.120.76.86:8003''. You need to make sure that there's an ''http://'' before the IP address, and '':8003'' after the IP address. 63 3. Select the address you just added and click the '''Connect''' button. You should be connected to the server.68 3. Select the address you just added, click the '''Connect''' button, and enter your username and password. You should be connected to the server. 64 69 4. The '''Server Resources''' should list the book that you've saved to Sophie Server. 65 70 5. Double-click the book you just saved. It should open.