Oolite Wiki
Moderators: winston, another_commander
- maik
- Wiki Wizard
- Posts: 2028
- Joined: Wed Mar 10, 2010 12:30 pm
- Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)
Re: Oolite Wiki
Good stuff! Thanks a bunch, Cholmondely!
- Cody
- Sharp Shooter Spam Assassin
- Posts: 16081
- Joined: Sat Jul 04, 2009 9:31 pm
- Location: The Lizard's Claw
- Contact:
Re: Oolite Wiki
Aye... good work, amigo!
I would advise stilts for the quagmires, and camels for the snowy hills
And any survivors, their debts I will certainly pay. There's always a way!
And any survivors, their debts I will certainly pay. There's always a way!
- Cholmondely
- Archivist
- Posts: 5405
- Joined: Tue Jul 07, 2020 11:00 am
- Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
- Contact:
Re: Oolite Wiki
Updating the wiki
Hiran, since the wiki is itself unavailable at the moment, this seems like the best place for discussing how to do it.
I would suggest dividing up the OXZs by category into more manageable chunks:
Activities
Ambience
Dockables
Equipment
HUDs
Mechanics
Miscellaneous
Missions
Retextures
Ships
Systems
Weapons
From http://www.oolite.org/oxps/?sort=c
As well as the blurb, there are
(i) the tags/categories
(ii) the assessments (how the OXZ affects gameplay makes it easier or tougher - or how good one needs to be to cope with the mission or what it does to the game)
(iii) computer assessments in terms of drain on CPU & graphics creation unit
(iv) links to the BB discussion threads and the author's User page (if there is one!)
One approach might be to select a category - something short maybe like Dockables, or something that really appeals to you - and then either we each attack it from different ends (A/Z) or we split each entry between us - you bung in the blurb and I take care of the trimmings.
What do you think?
Hiran, since the wiki is itself unavailable at the moment, this seems like the best place for discussing how to do it.
I would suggest dividing up the OXZs by category into more manageable chunks:
Activities
Ambience
Dockables
Equipment
HUDs
Mechanics
Miscellaneous
Missions
Retextures
Ships
Systems
Weapons
From http://www.oolite.org/oxps/?sort=c
As well as the blurb, there are
(i) the tags/categories
(ii) the assessments (how the OXZ affects gameplay makes it easier or tougher - or how good one needs to be to cope with the mission or what it does to the game)
(iii) computer assessments in terms of drain on CPU & graphics creation unit
(iv) links to the BB discussion threads and the author's User page (if there is one!)
One approach might be to select a category - something short maybe like Dockables, or something that really appeals to you - and then either we each attack it from different ends (A/Z) or we split each entry between us - you bung in the blurb and I take care of the trimmings.
What do you think?
Comments wanted:
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
- maik
- Wiki Wizard
- Posts: 2028
- Joined: Wed Mar 10, 2010 12:30 pm
- Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)
Re: Oolite Wiki
Do I understand your intention correctly, you want to copy the extension manager descriptions to the wiki?
- Cholmondely
- Archivist
- Posts: 5405
- Joined: Tue Jul 07, 2020 11:00 am
- Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
- Contact:
Re: Oolite Wiki
Hiran has suggested that (in collaboration with myself and anybody else who wishes to join in) we create new wiki pages for the OXZs on the Expansions Manager which have no such page.
So far I've not had to refer to the 'i' descriptions on the Expansions Manager, but it is a source of information where all else fails.
Unlike me, he is a practitioner of the Dark Arts.
Comments wanted:
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
- maik
- Wiki Wizard
- Posts: 2028
- Joined: Wed Mar 10, 2010 12:30 pm
- Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)
Re: Oolite Wiki
I wonder how we could automate this. Long-term it is a pain to maintain things twice, and thus will not happen consistently (e.g. if an OXZ author updates the description for the extension manager the copy on the wiki would need an update, too). Couldn't we have one source for this data only, and have both generated from this?Cholmondely wrote: ↑Mon Apr 05, 2021 11:42 amHiran has suggested that (in collaboration with myself and anybody else who wishes to join in) we create new wiki pages for the OXZs on the Expansions Manager which have no such page.
So far I've not had to refer to the 'i' descriptions on the Expansions Manager, but it is a source of information where all else fails.
Unlike me, he is a practitioner of the Dark Arts.
- montana05
- ---- E L I T E ----
- Posts: 1166
- Joined: Mon May 30, 2016 3:54 am
- Location: lurking in The Devils Triangle (G1)
Re: Oolite Wiki
I will be happy to assist, but I do agree with Malik, creating new pages for OXZ's missing them is great, as soon as you create new categories it would be advisable to add scripts for automation. Unfortunately now we already have a lot of pages from the past hardy to get updated.Cholmondely wrote: ↑Mon Apr 05, 2021 11:42 amHiran has suggested that (in collaboration with myself and anybody else who wishes to join in) we create new wiki pages for the OXZs on the Expansions Manager which have no such page.
So far I've not had to refer to the 'i' descriptions on the Expansions Manager, but it is a source of information where all else fails.
Unlike me, he is a practitioner of the Dark Arts.
Scars remind us where we've been. They don't have to dictate where we're going.
- hiran
- Theorethicist
- Posts: 2415
- Joined: Fri Mar 26, 2021 1:39 pm
- Location: a parallel world I created for myself. Some call it a singularity...
Re: Oolite Wiki
I thought of something like automatically generating wiki pages from expansions. This could be a small batch job that runs at regular intervals or maybe as part of the CI/CD pipeline.maik wrote: ↑Mon Apr 05, 2021 11:50 amI wonder how we could automate this. Long-term it is a pain to maintain things twice, and thus will not happen consistently (e.g. if an OXZ author updates the description for the extension manager the copy on the wiki would need an update, too). Couldn't we have one source for this data only, and have both generated from this?
- it starts off with a list of expansions - this could be the same source that the expansion manager[ uses. (see http://wiki.alioth.net/index.php/Expansions_Manager)
- From that list it uses the download links, then downloads and scans the OXPs, OXzs and whatever it can get hold of. Not sure here, currently I think reading the manifest could be sufficient, future versions could access more information.
- From this information we could then generate wiki pages, one or several if need be. Or filterable/sortable ones if that is possible.
- Finally these pages get uploaded into the oolite wiki.
Last edited by hiran on Mon Apr 05, 2021 6:04 pm, edited 1 time in total.
Sunshine - Moonlight - Good Times - Oolite
- hiran
- Theorethicist
- Posts: 2415
- Joined: Fri Mar 26, 2021 1:39 pm
- Location: a parallel world I created for myself. Some call it a singularity...
Re: Oolite Wiki
Thinking about this, it could be a very similar process to document ships.
And enemies.
And planets.
And...
The real benefit comes where the data is available in the wiki plus in the in-game information. Alternatively the game could just open a browser window for further reference - I find it a bit annoying to read long text in the limited text rendering capabilities of oolite.
Understand me right: I do not expect the text rendering of oolite to be improved. But let's use the wiki where it is strong and oolite for the game itself.
And enemies.
And planets.
And...
The real benefit comes where the data is available in the wiki plus in the in-game information. Alternatively the game could just open a browser window for further reference - I find it a bit annoying to read long text in the limited text rendering capabilities of oolite.
Understand me right: I do not expect the text rendering of oolite to be improved. But let's use the wiki where it is strong and oolite for the game itself.
Last edited by hiran on Mon Apr 05, 2021 6:05 pm, edited 1 time in total.
Sunshine - Moonlight - Good Times - Oolite
- Cholmondely
- Archivist
- Posts: 5405
- Joined: Tue Jul 07, 2020 11:00 am
- Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
- Contact:
Re: Oolite Wiki
Does Extension = Expansion = (OXZs & OXPs) ?
Comments wanted:
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
- Cody
- Sharp Shooter Spam Assassin
- Posts: 16081
- Joined: Sat Jul 04, 2009 9:31 pm
- Location: The Lizard's Claw
- Contact:
Re: Oolite Wiki
<nods sagely>
I would advise stilts for the quagmires, and camels for the snowy hills
And any survivors, their debts I will certainly pay. There's always a way!
And any survivors, their debts I will certainly pay. There's always a way!
- hiran
- Theorethicist
- Posts: 2415
- Joined: Fri Mar 26, 2021 1:39 pm
- Location: a parallel world I created for myself. Some call it a singularity...
Re: Oolite Wiki
I may be using the wrong words. Please forgive me...
Some domains call it extension, some expansion, some plugins, some addons, some ....
I was talking about the OXZs and OXPs.
Sunshine - Moonlight - Good Times - Oolite
- maik
- Wiki Wizard
- Posts: 2028
- Joined: Wed Mar 10, 2010 12:30 pm
- Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)
Re: Oolite Wiki
I agree the initial creation of wiki pages from manifests is not that hard to code, you just need a unique identifier across manifests and the wiki to not start creating duplicates.hiran wrote: ↑Mon Apr 05, 2021 2:11 pmI thought of something like automatically generating wiki pages from expansions. This could be a small batch job that runs at regular intervals or maybe as part of the CI/CD pipeline.maik wrote: ↑Mon Apr 05, 2021 11:50 amI wonder how we could automate this. Long-term it is a pain to maintain things twice, and thus will not happen consistently (e.g. if an OXZ author updates the description for the extension manager the copy on the wiki would need an update, too). Couldn't we have one source for this data only, and have both generated from this?
- it starts off with a list of expansions - this could be the same source that the expansion manager[ uses. (see http://wiki.alioth.net/index.php/Expansions_Manager)
- From that list it uses the download links, then downloads and scans the OXPs, OXzs and whatever it can get hold of. Not sure here, currently I think reading the manifest could be sufficient, future versions could access more information.
- From this information we could then generate wiki pages, one or several if need be. Or filterable/sortable ones if that is possible.
Not that hard to code. It would more require some knowledge about the expansions and the source to read and the destination to write.
- Finally these pages get uploaded into the oolite wiki.
The more difficult bit comes when there are updates. One author might leave the manifest as is and just update the wiki page, another might update the manifest but does not like editing the wiki, and the third one is happy to keep both in sync
I believe we should have a complete strategy before we implement such automation. The risk to mess up the wiki is quite real
I can see if I can create a wiki playground again for testing when we get somewhat further.
- hiran
- Theorethicist
- Posts: 2415
- Joined: Fri Mar 26, 2021 1:39 pm
- Location: a parallel world I created for myself. Some call it a singularity...
Re: Oolite Wiki
For updates you mention different cases:maik wrote: ↑Mon Apr 05, 2021 7:24 pmI agree the initial creation of wiki pages from manifests is not that hard to code, you just need a unique identifier across manifests and the wiki to not start creating duplicates.
The more difficult bit comes when there are updates. One author might leave the manifest as is and just update the wiki page, another might update the manifest but does not like editing the wiki, and the third one is happy to keep both in sync
I believe we should have a complete strategy before we implement such automation. The risk to mess up the wiki is quite real
- Automatically generated pages: This is trivial as for updates we can simply overwrite the page.
- Some authors just update the wiki page: We could track for manual changes and no longer auto-update the page - but this behaviour would mean once touched it is back in manual mode, and the quality would deteriorate. Therefore I propose to discourage manually updating pages that were generated or even protect them from interactive users.
- Those that update the manifest only are the good boys, and the first rule applies.
- A bit stranger is if users keep both manifest and wiki page up to date. This is the only case where I see a strategy is necessary. But once we have the automation ready a goal should be set to synchronize the data on the manually maintained wiki pages into the OXPs so we have one source of truth. OXP maintainers should actually agree as from then on they only would have to care about their OXP and the inclusion in the OXP list but nothing else. it eases their life.
This is actually the best approach to move on.
Sunshine - Moonlight - Good Times - Oolite
- hiran
- Theorethicist
- Posts: 2415
- Joined: Fri Mar 26, 2021 1:39 pm
- Location: a parallel world I created for myself. Some call it a singularity...
Re: Oolite Wiki
In the meantime I could give that batch job a try.
Who knows which download URL is used by the Expansion Manager to get the most up to date list of plugins?
I found this line so far:
https://github.com/OoliteProject/oolite ... ager.m#L48
which indicates to me this would be the URL used by oolite to find expansions:
http://addons.oolite.org/api/1.0/overview
Next is to figure out syntax and grammar of the data. Or the best parser to choose, as I'd prefer to not implement that myself.
However I am not familiar with Objective C, yet it seems the data format is whatever is generated using the NSCoding protocol.
Who knows which download URL is used by the Expansion Manager to get the most up to date list of plugins?
I found this line so far:
https://github.com/OoliteProject/oolite ... ager.m#L48
which indicates to me this would be the URL used by oolite to find expansions:
http://addons.oolite.org/api/1.0/overview
Next is to figure out syntax and grammar of the data. Or the best parser to choose, as I'd prefer to not implement that myself.
However I am not familiar with Objective C, yet it seems the data format is whatever is generated using the NSCoding protocol.
Sunshine - Moonlight - Good Times - Oolite