Oolite Bulletins

For information and discussion about Oolite.
It is currently Sat Dec 16, 2017 3:31 am

All times are UTC




Post new topic  Reply to topic  [ 56 posts ]  Go to page Previous 1 2 3 4 Next
Author Message
PostPosted: Mon Jul 16, 2012 11:54 am 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Sun Apr 29, 2012 2:23 pm
Posts: 883
Location: United Kingdom
Ah, I may have been going about this in the wrong way then. Think I may have over complicated it for myself! :lol:

I will try again tonight to see if I can convert it, and if not I will simply have to exclude it from my next release. Thanks Ahruman! :)


Top
   
PostPosted: Mon Jul 16, 2012 4:18 pm 
Offline
Dangerous
Dangerous
User avatar

Joined: Thu Feb 09, 2012 9:03 am
Posts: 108
Having never developed an OXP, the only disadvantage I noticed with Notepad is the lack of displayed line-breaks when viewing Unix formatted text files. (As an aside, I never heard anyone speak quite that highly of Windows Me - in my opinion, having only very briefly used it at a friend's place, the biggest problem after lack of Unicode was its FAT32-imposed file size limitation. The commonly-cited problem with crashes after resuming from sleep when some USB device had come unplugged was just a config issue, then?)


Top
   
PostPosted: Mon Jul 16, 2012 5:02 pm 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Sat Jun 11, 2011 6:07 am
Posts: 2161
Location: Western Australia
Quote:
As an aside, I never heard anyone speak quite that highly of Windows Me - in my opinion, having only very briefly used it at a friend's place, the biggest problem after lack of Unicode was its FAT32-imposed file size limitation. The commonly-cited problem with crashes after resuming from sleep when some USB device had come unplugged was just a config issue, then?
I don't know about that. "Out of the box" it was a shocker. But I found most of the problems seemed to be caused by System Restore (a shiny, new feature in ME). Once I learnt how to disable that it just hummed along. I didn't see a BSOD for years (and never had an occasion when I thought, "I wish I could do a system restore."), until the computer started playing up a few months before it finally gave up the ghost. I wish my current celeron/Win7 notebook was as reliable. It freezes up almost daily.

Now, about this converting <pointyBrackets>XML<pointyBrackets> business. It's very simple XML with no attributes, mixed namespaces, or other hoopla, so a CSS stylesheet should be all you need. You just need to know all the the possible element types... <string></string> <array></array> <key></key> etc...?


Top
   
PostPosted: Mon Jul 16, 2012 6:21 pm 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Thu May 10, 2012 9:41 pm
Posts: 877
Location: Derby
There is also a converter to change XML to Openstep (Section 7 of the Property list doc on the Wiki).

See here http://wiki.alioth.net/index.php/Property_list

_________________
The GalTech Industries Corporation - Building ships to populate the galaxies.

Increase the variety of ships within your Ooniverse by downloading my OXPs

Flying the [wiki]Serpent_Class_Cruiser[/wiki] "Thargoid's Bane"


Top
   
PostPosted: Tue Jul 17, 2012 12:52 pm 
Offline
Grand Admiral Emeritus
Grand Admiral Emeritus
User avatar

Joined: Sat Apr 02, 2005 2:43 pm
Posts: 6657
Location: Sweden
Rewove the threads by request.

_________________
E-mail: jens@oolite.org


Top
   
PostPosted: Sat Jul 21, 2012 12:36 pm 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Wed May 20, 2009 6:48 pm
Posts: 603
Location: Somewhere off the top left of Galaxy 1 map
After reading SandJ's list of ideas (now deleted) I was able to see that I have left out some additional areas that this thread should cover. These are:
  • Correct packing of the OXP. Including documentation and Change Logs files.
  • Version numbering.
  • Licensing & copyrights.
  • Documentation writing.
  • Wiki entries for OXP.
I am about to add these to the first post

To start here are few points for the Basic Dos and Don'ts:
Dos:
  • Always comment your code. It helps both you and others later if you put comments in your code that explains what each function does or what certain parts of the code do. The more thorough the commenting is the easier debugging and maintaining is.
  • Always indent your code. Either use a tab or a fixed set of spaces for each level of indenting. If you uses tabs always use tabs. If you use n spaces always use n spaces. Doing this will indent your code consistently so it is much easier to read and to find the relationship between parts of the code.
Don'ts:
  • Do not create global variables always do this.<varname> = <value/expression> never do var <varname> = <value/expression> that are not inside a function. Reason is because the var ... form when not inside a function is global and that variable name could already be used by some other OXP. Using "this" to declare them makes the variable part of the worldScript object that is your script and therefore will never clash with a variable from another OXP. Generally there is no need to create a global but if you find a reason to do so it is suggested you prefix the variable name with the name of the OXP. (This reduces the chance of a name clash)
  • Do not hard code System names in mission screen and manifest screen instruction texts. Instead use the code "%Jxxx" where xxx is the number of the system. (e.g. "Go to LAVE main station to collect Agent Jones" should be "Go to %J007 main station to collect Agent Jones".) The reason for doing this is that names of systems can be altered by OXPs so you can't be guarantee that it will always be the name you hardcoded into the text. "%Jxxx" is one of the codes that get automatically substituted in mission and description texts.

_________________
Chat and relax with other commanders in the [url=irc://irc.oftc.net/oolite]DS's Seedy Space Bar[/url]. The Coolest Bar in the Eight.

Phantor's OXPs: [EliteWiki] GalCop Rewards and [EliteWiki] Safe Docking


Top
   
PostPosted: Sat Jul 21, 2012 3:04 pm 
Offline
Grand Admiral Emeritus
Grand Admiral Emeritus
User avatar

Joined: Sat Apr 02, 2005 2:43 pm
Posts: 6657
Location: Sweden
Quote:
  • Correct packing of the OXP. Including documentation and Change Logs files.
Don’t put your OXP and its documentation in a folder also called <something>.oxp. It causes confusion about what actually constitutes the OXP, and on Macs the entire folder will appear as a single file so the documentation can’t be seen.

_________________
E-mail: jens@oolite.org


Top
   
PostPosted: Sat Jul 21, 2012 5:09 pm 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Wed May 20, 2009 6:48 pm
Posts: 603
Location: Somewhere off the top left of Galaxy 1 map
Quote:
Quote:
  • Correct packing of the OXP. Including documentation and Change Logs files.
Don’t put your OXP and its documentation in a folder also called <something>.oxp. It causes confusion about what actually constitutes the OXP, and on Macs the entire folder will appear as a single file so the documentation can’t be seen.
I think I am guilty of this one!

So what is the best high level structure:
Code:
Name.zip
   ├> Name.oxp (folder)
   │     ├> (subfolder)
   │     ┊
   │
   └> Documention (file)
or
Code:
Name.oxp.zip
   ├> Config (folder)
   ├> Models (folder)
   ┊     
   └> Documention (file)
?

_________________
Chat and relax with other commanders in the [url=irc://irc.oftc.net/oolite]DS's Seedy Space Bar[/url]. The Coolest Bar in the Eight.

Phantor's OXPs: [EliteWiki] GalCop Rewards and [EliteWiki] Safe Docking


Top
   
PostPosted: Sat Jul 21, 2012 5:19 pm 
Offline
Retired Assassin
Retired Assassin
User avatar

Joined: Tue Feb 09, 2010 11:31 am
Posts: 8311
Location: Disunited Kingdom
The .zip file should contain the .oxp folder, and a readme (and any other documentation).

_________________
Commander Smivs, the friendliest Gourd this side of Riedquat.


Top
   
PostPosted: Sat Jul 21, 2012 5:20 pm 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Wed May 20, 2009 6:48 pm
Posts: 603
Location: Somewhere off the top left of Galaxy 1 map
Quote:
The .zip file should contain the .oxp folder, and a readme (and any other documentation).
So the first example I gave then?

_________________
Chat and relax with other commanders in the [url=irc://irc.oftc.net/oolite]DS's Seedy Space Bar[/url]. The Coolest Bar in the Eight.

Phantor's OXPs: [EliteWiki] GalCop Rewards and [EliteWiki] Safe Docking


Top
   
PostPosted: Sat Jul 21, 2012 5:21 pm 
Offline
Sharp Shooter Spam Assassin
Sharp Shooter Spam Assassin
User avatar

Joined: Sat Jul 04, 2009 9:31 pm
Posts: 12967
Location: Corke's Drift
Code:
Name.zip
   │
Name (folder)
   ├> Name.oxp (folder)
   │     ├> (subfolder)
   │     ┊
   │
   └> Documention (file)
Perhaps?

_________________
The only good fnord is a dead fnord!


Top
   
PostPosted: Sat Jul 21, 2012 5:26 pm 
Offline
Retired Assassin
Retired Assassin
User avatar

Joined: Tue Feb 09, 2010 11:31 am
Posts: 8311
Location: Disunited Kingdom
Code:
       .zip
         |
 ------------------
 |                |
.oxp            readme
 |
sub-folders eg Config

_________________
Commander Smivs, the friendliest Gourd this side of Riedquat.


Top
   
PostPosted: Sat Jul 21, 2012 5:27 pm 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Wed May 20, 2009 6:48 pm
Posts: 603
Location: Somewhere off the top left of Galaxy 1 map
EV's version modified for consistency
Quote:
Code:
Name.zip
   └>Name (folder)
        ├> Name.oxp (folder)
        │     ├> (subfolder)
        │     ┊
        │
        └> Documention (file)

Perhaps?
Given that most OSs/Archiving Programs treat the .zip file as a special kind of folder surely that having a folder Name is redundant?

_________________
Chat and relax with other commanders in the [url=irc://irc.oftc.net/oolite]DS's Seedy Space Bar[/url]. The Coolest Bar in the Eight.

Phantor's OXPs: [EliteWiki] GalCop Rewards and [EliteWiki] Safe Docking


Top
   
PostPosted: Sat Jul 21, 2012 5:28 pm 
Offline
---- E L I T E ----
---- E L I T E ----
User avatar

Joined: Wed May 20, 2009 6:48 pm
Posts: 603
Location: Somewhere off the top left of Galaxy 1 map
Quote:
Code:
       .zip
         |
 ------------------
 |                |
.oxp            readme
 |
sub-folders eg Config
that's the same as my:
Code:
Name.zip
   ├> Name.oxp (folder)
   │     ├> (subfolder)
   │     ┊
   │
   └> Documention (file)
I better go and update my OXPs then :-(

_________________
Chat and relax with other commanders in the [url=irc://irc.oftc.net/oolite]DS's Seedy Space Bar[/url]. The Coolest Bar in the Eight.

Phantor's OXPs: [EliteWiki] GalCop Rewards and [EliteWiki] Safe Docking


Top
   
PostPosted: Sat Jul 21, 2012 5:31 pm 
Offline
Sharp Shooter Spam Assassin
Sharp Shooter Spam Assassin
User avatar

Joined: Sat Jul 04, 2009 9:31 pm
Posts: 12967
Location: Corke's Drift
Quote:
... surely that having a folder Name is redundant?
That's how I find many OXPs packaged already - it makes sense to me, but that means zilch!

_________________
The only good fnord is a dead fnord!


Top
   
Display posts from previous:  Sort by  
Post new topic  Reply to topic  [ 56 posts ]  Go to page Previous 1 2 3 4 Next

All times are UTC


Who is online

Users browsing this forum: No registered users and 18 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum

Search for:
cron
Powered by phpBB® Forum Software © phpBB Limited