Jump to content

Is there a real API documentation?


hottehead

Recommended Posts

Im trying to find a documentation of the API? Is there any like for other languages or frameworks? 

 

In particular I tried to find the "Minimap:ShowArea" function which a lot of people use to reveal the map. I want to get an overview about how the minimap works. But I couldnt find this function at all. I have searched the whole DST folder with an external tool to find this string in any file, but had no luck.

 

So, how am I supposed to get knowledge of the functionality offered?

 

 

greetings hottehead

Link to comment
Share on other sites

I just started checking out how to mod and learning some more LUA but maybe the community can get together and start a documentation as a wiki or something? There are lots of methods where i don't really know what the parameters all do, would be cool to have this info in one place.

Link to comment
Share on other sites

I just started checking out how to mod and learning some more LUA but maybe the community can get together and start a documentation as a wiki or something? There are lots of methods where i don't really know what the parameters all do, would be cool to have this info in one place.

I like that idea, it would really be a good resource for modding.

Link to comment
Share on other sites

Okay, so everyone would benefit from this I think. Question is how should we do it? A forum thread isnt suited for that.

I found this tool: https://github.com/tripit/slate. Something like this would be cool I think. Everyone could create an account and fill in the stuff he knows. If someone knows a better tool which can be hosted in the web, please link it here. 

 

If the right tool is found, I'll host the application on my server.

Link to comment
Share on other sites

I gave it a shot this evening. You can see my template here http://hottehead.github.io/APIDocs. The repository is located at https://github.com/hottehead/APIDocs. You can fork and edit it if u want to try it, too. 

 

Documentation can be done with this tool as long as everyone sticks to some formatting rules, because it's only a few markdown files. The produced HTML is quite okay, not too good.

 

I'll try to structure the document tomorrow evening to suit the Dont Starve structure. 

Link to comment
Share on other sites

I gave it a shot this evening. You can see my template here http://hottehead.github.io/APIDocs. The repository is located at https://github.com/hottehead/APIDocs. You can fork and edit it if u want to try it, too. 

 

Documentation can be done with this tool as long as everyone sticks to some formatting rules, because it's only a few markdown files. The produced HTML is quite okay, not too good.

 

I'll try to structure the document tomorrow evening to suit the Dont Starve structure. 

 

I've used github criminally little, but I'll definitely look into working on this. Seems like a good start way to go!

Link to comment
Share on other sites

I figured that using GIT is too much effort for someone to contribute a few lines. I've setup a simple wordpress installation and wrote a basic structure with very little content so far. The wordpress theme is simply the default theme.

I'd like to hear your opinion. Does this make sense? Would you contribute? 

 

http://128.199.40.198/wordpress/

Link to comment
Share on other sites

I figured that using GIT is too much effort for someone to contribute a few lines. I've setup a simple wordpress installation and wrote a basic structure with very little content so far. The wordpress theme is simply the default theme.

I'd like to hear your opinion. Does this make sense? Would you contribute? 

 

http://128.199.40.198/wordpress/

 

That looks fine. It is better than the current API because it exists. =)

 

I would really get behind this.

Link to comment
Share on other sites

@hottehead, I would definitely contribute.

My biggest concern would be proper syntax highlighting. It may not seem like much, but it can make code significantly easier to skim through. I'm not aware how easy it will be to implement that with wordpress.

Secondly, the theme does not match Dont Starve, and doesn't seem to be very code-oriented either.

Regardless, anything is a good start. Those things can be improved in time.

 

Tripit slate was rather appealing, though. If only there was a way to combine the ease of use with appealing functionality.

 

 

..current API because it exists

Interesting. I haven't come across it till now and assumed there wasn't one at all after searching a bit. Do you have a link for it? I'd like to check it out.

Just to confirm though, you are talking about an official API documentation, not just the API itself, right?

 

Link to comment
Share on other sites

Interesting. I haven't come across it till now and assumed there wasn't one at all after searching a bit. Do you have a link for it? I'd like to check it out.

Just to confirm though, you are talking about an official API documentation, not just the API itself, right?

 

Context is important. :p

 

He said "It (this topic) is better than the current api, because it (this topic) exists."

Link to comment
Share on other sites

@Blueberrys

Sorry, I meant that his version was better then other versions because there are no other versions.

It was a poor attempt at humor.

 

Context is important. :razz:

 

He said "It (this topic) is better than the current api, because it (this topic) exists."

 

Oh, I see. Sorry about that. Makes much more sense that way, haha. Thanks for clarifying.

 

Link to comment
Share on other sites

Yeah i don't know if the wordpress site would work, having something like Slate but not having to use git would be useful for people who don't know much about git. 

 

I think if we'd go with a wordpress style of thing, we might as well add it to dont starve wiki? (Maybe klei can create a separate modding/programming wiki). 

Link to comment
Share on other sites

@SeriousCreeper,

The only dont starve wiki I know of doesn't contain much information on mods at all. It's very out dated and pretty messy in that department. You do have a point though, we could just use a wiki, but I'd suggest using a new one dedicated to modding (perhaps using Dokuwiki?). It would be ideal if Klei creates it, but that might not happen any time soon.

Link to comment
Share on other sites

Yay, thanks for the response. Cool to see that you are interested!

 

@Blueberrys:

You are right, syntax highlighting is really important. I solved it by installing this plugin https://wordpress.org/plugins/crayon-syntax-highlighter/ and made a demo code here http://128.199.40.198/wordpress/?page_id=38 . Everyone can easily create this code blocks in the WP-Editor and almost everything is customizable in this plugin.

I also installed the TablePress plugin https://wordpress.org/plugins/tablepress/ . This helps to create Tables of fields and methods.

Overall I know wordpress and the theme isnt exactly suited for an API Doc. But I think its a good starting point and we could improve it over time together, i.e. make a better navigation structure. Furthermore wordpress is something I am quite experienced in, which reduces the time I need to make adjustements.

 

Concerning Dokuwiki:

Dokuwiki also is quite good. Im using it for another project. But overall it's a little more complex to keep the structure. I think unexperienced users would have problems getting started and may produce messy files which are hard to maintain. I want to make it as easy as possible so that everyone can contribute.

 

 

Link to comment
Share on other sites

Thanks! =)

 

This site actually is the real one. Just register and wait for me to approve. I activated approval because I dont want everyone to gain immediate access. After that you can start adding content, the basic structure should be clear I think.

We will give it a proper URL in the near future. Need to talk with KLEI staff about what name we are allowed to pick.

 

Have fun and Im excited about how we will develop this further.

Link to comment
Share on other sites

@hottehead, good thinking. I registered as Blueberrys.

 

We will give it a proper URL in the near future. Need to talk with KLEI staff about what name we are allowed to pick.

That would be nice. They're usually pretty lenient on these things, so it shouldn't be an issue. Think of a good one then ask em.

Link to comment
Share on other sites

@hottehead, I did not, actually. Could it be because I used an alias (+ symbol)?

 

Nope, looks like its an issue with sendmail on my machine. Anyways I send you a handmade mail with your credentials :livid:  Gonna try to fix it this evening. And if I have time afterwards I will write a little to get this thing started.

 

@boardman94:

You registered before the activation plugin? Can you login?

Link to comment
Share on other sites

Archived

This topic is now archived and is closed to further replies.

Please be aware that the content of this thread may be outdated and no longer applicable.

×
  • Create New...