Minetest logo

IRC log for #minetest-docs, 2022-01-06

| Channels | #minetest-docs index | Today | | Google Search | Plaintext

All times shown according to UTC.

Time Nick Message
00:01 MTDiscord <GreenXenith> even with <1> syntax, it wants it to be ordered
00:02 MTDiscord <Benrob0329> That's what I saw, we can probably just manually number them outside the code block though and not use the fancy syntax there
00:02 MTDiscord <GreenXenith> so the table thing I showed above
00:03 MTDiscord <Benrob0329> or a horizontal d-list
00:03 MTDiscord <GreenXenith> a what now
00:07 MTDiscord <Benrob0329> https://cdn.discordapp.com/attachments/926231483155378176/928439530980270110/unknown.png
00:07 MTDiscord <Benrob0329> https://cdn.discordapp.com/attachments/926231483155378176/928439624609718312/unknown.png
00:07 MTDiscord <Benrob0329> the lone + says "attach this to the previous block"
00:09 MTDiscord <GreenXenith> ah
00:15 MTDiscord <GreenXenith> https://cdn.discordapp.com/attachments/926231483155378176/928441614303653938/unknown.png
00:16 MTDiscord <Benrob0329> I think that works
00:16 MTDiscord <Benrob0329> now my question is, what does the docbook output look like?
00:17 MTDiscord <GreenXenith> how do I figure that out
00:17 MTDiscord <Benrob0329> https://docs.asciidoctor.org/asciidoctor/latest/docbook-backend/
00:25 MTDiscord <GreenXenith> https://cdn.discordapp.com/attachments/926231483155378176/928444016951984148/unknown.png
00:25 MTDiscord <Benrob0329> It is easier to parse from code though, being XML?
00:25 MTDiscord <Benrob0329> ie, will it be easier to drop it into an XML parser and use that in tooling?
00:26 MTDiscord <GreenXenith> Im sure node has a decent XML parser
00:26 MTDiscord <Benrob0329> So that's a "maybe"
00:26 MTDiscord <GreenXenith> anything easier than what we have, yeah?
00:27 MTDiscord <Benrob0329> true
00:27 MTDiscord <GreenXenith> html output works
00:30 MTDiscord <GreenXenith> So are we cool with this format?
00:30 MTDiscord <Benrob0329> it gets my vote
00:31 MTDiscord <GreenXenith> if I want custom macros do I need to do some ruby stuff
00:31 MTDiscord <Benrob0329> for real fancy stuff yeah
00:31 MTDiscord <josiah_wi> I like how it looks.
00:32 MTDiscord <Benrob0329> I'll probably set up some editor macros for right now
00:32 MTDiscord <josiah_wi> Are the numbered lists contributing anything?
00:32 MTDiscord <GreenXenith> overloads
00:32 MTDiscord <GreenXenith> only used if there are multiple return cases
00:32 MTDiscord <Benrob0329> leave them out otherwise?
00:32 MTDiscord <GreenXenith> yeah
00:32 MTDiscord <josiah_wi> Gotcha.
00:39 MTDiscord <GreenXenith> https://cdn.discordapp.com/attachments/926231483155378176/928447548870520852/unknown.png
00:39 MTDiscord <GreenXenith> https://cdn.discordapp.com/attachments/926231483155378176/928447606886129724/unknown.png
00:39 MTDiscord <GreenXenith> https://cdn.discordapp.com/attachments/926231483155378176/928447696996552744/unknown.png
00:40 MTDiscord <GreenXenith> https://cdn.discordapp.com/attachments/926231483155378176/928447812797091860/unknown.png
00:40 MTDiscord <GreenXenith> (ignore the incorrect return values on vehicle new)
00:40 MTDiscord <MisterE> Where can I find these minetest docs or are they not available yet?
00:41 MTDiscord <GreenXenith> we're making them right now
00:41 MTDiscord <Benrob0329> Soon™️
00:42 MTDiscord <MisterE> Can you have a snippets section on each page? It doesn't have to be filled in rn, but they can be collected (automatically?) and snippets make coding so much easier
00:43 MTDiscord <GreenXenith> theres a snippet on the last one
00:43 MTDiscord <GreenXenith> its right there
00:43 MTDiscord <MisterE> The psage section is a good start
00:43 MTDiscord <GreenXenith> big red letters "Example 1"
00:43 MTDiscord <MisterE> I see that but ignored it because in was about vehicles, not minetest XD
00:44 MTDiscord <MisterE> Ok, that good!
00:44 MTDiscord <GreenXenith> the example is related to Minetest more than you'd think :]
00:44 MTDiscord <GreenXenith> but we will have collections of more snippets externally linked probably
00:44 MTDiscord <GreenXenith> but thats for later
00:45 MTDiscord <GreenXenith> I really need some macros for this
00:46 MTDiscord <Benrob0329> I really wish that there were ways to make basic macros that carried actual syntax
00:48 MTDiscord <GreenXenith> there is a hack to do it
00:48 MTDiscord <GreenXenith> https://stackoverflow.com/a/37397532
00:48 MTDiscord <GreenXenith> its gross though :]
00:49 MTDiscord <Benrob0329> Not the worst, I think I had a similar idea a while back but want to avoid includes everywhere
00:50 MTDiscord <GreenXenith> you could substitute the include
00:50 MTDiscord <GreenXenith> hack the hack
00:50 MTDiscord <Benrob0329> Nope
00:50 MTDiscord <Benrob0329> include:: is a preprocessor macro
00:50 MTDiscord <GreenXenith> darn
00:50 MTDiscord <Benrob0329> it works differently and before the main asciidoc stuff, that's why it's able to insert actual syntax
00:51 MTDiscord <Benrob0329> We can just make the table header it's own includable adoc file ofc
00:51 MTDiscord <GreenXenith> wdym?
00:52 MTDiscord <Benrob0329> make an include/ptable.adoc and include it
00:52 MTDiscord <Benrob0329> it would have the table header in it
00:52 MTDiscord <GreenXenith> the [] thing?
00:52 MTDiscord <Benrob0329> include::file[] is the include macro, file being the file you wish to include
00:52 MTDiscord <GreenXenith> I mean the table header
00:52 MTDiscord <GreenXenith> its the [%auto, frame] thing right?
00:53 MTDiscord <Benrob0329> yeah
00:53 MTDiscord <Benrob0329> and possibly the |===
00:53 MTDiscord <Benrob0329> really, the rows themselves are fine
00:53 MTDiscord <Benrob0329> and honestly, if we could set the default table properties then I'd be fine
00:54 MTDiscord <GreenXenith> how do you put newlines in variables :thonking:
00:54 Desour_ (btw, if someone wants to see the vehicle example in ldoc: https://0x0.st/ozfP.zip )
00:55 MTDiscord <MisterE> Is vehicle going to be a special type of minetest object optimized for attachment?
00:56 MTDiscord <Benrob0329> its just out example, for the template
00:56 MTDiscord <Benrob0329> *our
00:56 MTDiscord <GreenXenith> MisterE, you know this project is to revamp the existing documentation, right?
00:57 MTDiscord <MisterE> yes
00:57 MTDiscord <Benrob0329> @GreenXenith append + to the end of the line, after a space
00:57 MTDiscord <MisterE> But you gave me a teaser and it teased me
00:57 MTDiscord <Benrob0329> note that you will have to inset an extra blank line to make something a new paragraph/block
00:58 MTDiscord <GreenXenith> can you not use variables for table headers
00:58 MTDiscord <GreenXenith> or am I just doing something wrong
00:58 MTDiscord <Benrob0329> not afaik, but I have an idea
00:59 MTDiscord <GreenXenith> darn, {begin-table} | foo | bar {end-table} would have been nice :/
00:59 MTDiscord <GreenXenith> Desour_: The main reason we dont want to use DSL like ldoc is because of how difficult it is to write
00:59 Desour_ yeah, maybe you should use something as example of which people will think less likely that it will really be added to minetest, what about VoxelEntity?
01:00 MTDiscord <Benrob0329> sscsm is clearly the way to go then /s
01:00 MTDiscord <GreenXenith> The point is its supposed to be fake
01:00 MTDiscord <GreenXenith> its a template
01:00 MTDiscord <GreenXenith> im leaving it as vehicle
01:00 MTDiscord <Benrob0329> It's a joke, green
01:00 MTDiscord <GreenXenith> I wasnt responding to your joke
01:00 MTDiscord <Benrob0329> his is a joke
01:01 Desour_ :]
01:01 MTDiscord <Benrob0329> VoxelEntity doesn't exist and probably never will :-)
01:01 MTDiscord <Benrob0329> Not in the engine, anyways
01:01 MTDiscord <GreenXenith> (as the creator of the only VoxelEntity implementation worth beans, I take offense to that)
01:02 MTDiscord <GreenXenith> anyway whats your idea for table stuff
01:02 MTDiscord <MisterE> How about 'meme'  'meme.new'
01:02 erlehmann how about omskbird
01:03 erlehmann bring back oerkki
01:03 MTDiscord <MisterE> Yeah actually this prob isn't helping
01:03 MTDiscord <Benrob0329> I was thinking that maybe having it insert a passthrough block would work, but it doesn't seem to be
01:03 erlehmann VoxelEntity is not real it can't hurt you
01:04 MTDiscord <GreenXenith> VoxelEntity: https://github.com/GreenXenith/lvae/
01:04 erlehmann GreenXenith btw, did you make some ship or airship mod with that?
01:04 MTDiscord <GreenXenith> I have not ported my original ship mod to it yet
01:04 MTDiscord <GreenXenith> Maybe ill work on that this week
01:05 erlehmann wait you have an original ship mod that is similar?
01:05 MTDiscord <GreenXenith> The first version of the mod was for making ships, before I turned it into a general api
01:05 MTDiscord <GreenXenith> I might have a screenshot somewhere, but #minetest-irc
01:07 GreenXenith joined #minetest-docs
01:18 MTDiscord <GreenXenith> So, any other ideas @Benbob0329 ?
01:18 MTDiscord <GreenXenith> or should I figure out how to ruby this
01:22 MTDiscord <Benrob0329> I don't have any other ideas, I expect we'll be using the diagram plugin anyways for some stuff so plugins aren't a bad thing
01:22 MTDiscord <GreenXenith> so should I ruby it?
01:23 MTDiscord <GreenXenith> meh, that looks complicated ?
01:44 MTDiscord <Benrob0329> I might try my hand at it sometime, I don't think we need it right now
02:10 MTDiscord <GreenXenith> Did we decide what property tables should look like?
02:11 MTDiscord <GreenXenith> Some properties may be self-documented so a def list doesnt really work
02:28 MTDiscord <exe_virus> True, c++ supporter voxel entities will probably become a thing in minetest, someday. They'd be restricted in size, probably represented as a mapblock, and have a pre-calculation pass like the terrain so that it behaves as one .obj like object until built onto
02:28 MTDiscord <GreenXenith> #minetest-irc for further vae please
02:29 MTDiscord <exe_virus> Sorry, just musing in my one minute I have today to spare.
02:29 MTDiscord <exe_virus> ?
05:00 MTDiscord joined #minetest-docs
08:35 erlehmann joined #minetest-docs
11:58 appguru joined #minetest-docs
12:47 appguru joined #minetest-docs
17:40 MTDiscord <exe_virus> Fun fact: docs.microsoft.com is running on markdown
17:40 MTDiscord <exe_virus> With a lot of customizations haha.
17:53 MTDiscord <j45> haha noice
17:53 MTDiscord <j45> https://cdn.discordapp.com/attachments/926231483155378176/928707739071430686/unknown.png
17:54 MTDiscord <j45> btw, any preferred ways for me to document the default values? if noone feels strongly about this, i will do it in a bullet point, under the internal/field type
18:27 MTDiscord <j45> also, benrob, what do you mean by "Use a named example block please."?
18:43 definitelya joined #minetest-docs
18:43 MTDiscord <j45> @Luatic the default values i put are the ones in object_properties.h, i dont have the the to dig into the minetest pit to find out if it is changed elsewhere
18:43 MTDiscord <luatic> Well sorry that's incorrect
18:43 MTDiscord <luatic> Because we're documenting the Lua API
18:44 MTDiscord <luatic> So you have to look at the defaults that are set if the values aren't set in the Lua table
18:44 definitelya Oh right, there's no ilbot here.
18:44 definitelya cya
18:45 definitelya left #minetest-docs
19:25 MTDiscord <Benrob0329> I mean to use an example block, and give it a name
19:25 MTDiscord <Benrob0329> https://docs.asciidoctor.org/asciidoc/latest/blocks/example-blocks/#delimited
19:33 MTDiscord <j45> I see
19:35 MTDiscord <Benrob0329> You can place a source block inside an example if its delimited
19:35 MTDiscord <j45> Will fix that tmr(i think)
22:23 MTDiscord <josiah_wi> Maybe I can find where other default values are set.

| Channels | #minetest-docs index | Today | | Google Search | Plaintext