Im lost, what markup language is used to create pages for the nomad network?

[dog-girl-juno]

I want to get started building a "web" page for the nomad network. But I am having a lot of trouble finding documentation that talks about what specific markup language is used for creating pages. The documentation I have found so far talks about having a markup language for pages, but doesn't specify what language is used. Micron is mentioned a few times, but I am not sure if my google results are showing me what I actually want because there are other languages called micron for AI chips apparently? Any help or links to pages that have guides, documentation.. I will take basically anything at this point.

[dog-girl-juno]

I did find the Markup in the man pages for the nomadnet client on linux. But this doesnt really show me how to do it. Reading the page doesnt show me HOW to code in it, i guess i just learn differently than the man pages are showing me the information. Are there any online guides (preferably videos) or examples? I am also confused on whether this is written in a larger python file, if its a .mu file that i script with python or if its functional on its own. I looked at the example file but that just confused me more. Im seriously lost here.

[worst-git-server]

if you scroll to the bottom you can see the source of that same page, I find that it helps a lot.

[Swissbandit]

Hi. There is a chapter on micron in the nomadnetwork guide, navigate to the tab guide and choose markup.
(should may better say micron markup)
also on my node are some pages explaining a bit.
and if you load nomadnode pages (the static ones) you can watch them raw in any editor, when inspecting the files in the cache folder of .nomadnet
make the pages as you wish, call them .mu and place them in the pages folder, then place a link on your index.mu node startpage.
restart nomadnet to get new pages active,browse your own while you build it, also via meshchat.

for static .mu micron pages, one can easy just rename markdown or any.txt files to get something up, and thinker with it a bit.
but with micron you have full control of the looks.

for more interactive stuff one can make scripts like in a .mu using shebangs like #!/usr/bin/env python3
or using scripts running besides nomadnet, using the shared instance of the node to be of service.

[faragher]

An .mu file without the executable bit set is read as a text file; your Micron encoded text file will be displayed. An .mu file with the executable bit set will be run. For example, with the bit set and a file starting "#! /usr/bin/python3" will be run as a python3 file, and the output to the terminal (such as print () commands **and any RNS logs, error messages, etc.** will be rendered using Micron formatting. So you can make flat pages as text, and dynamic pages using basically anything that runs and outputs to the terminal, but it needs to terminate, so you can't wait for input or anything.

…

On Sat, Jan 18, 2025, 12:17 PM Swissbandit ***@***.***> wrote: Hi. There is a chapter on micron in the nomadnetwork guide, navigate to the tab guide and choose micron. also on my node are some pages explaining a bit. and if you load nomadnode pages (the static ones) you can watch them raw in any editor, when inspecting the files in the cache folder of .nomadnet make the pages as you wish, call them .mu and place them in the pages folder, then place a link on your index.mu node startpage. restart nomadnet to get new pages active,browse your own while you build it, also via meshchat. — Reply to this email directly, view it on GitHub <#677 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ALIZNI3L5WONZUCLF4IZORT2LKLBZAVCNFSM6AAAAABVNFCQTWVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTCOBXGY4DCNQ> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.*** com>

[fotografm]

I am also starting to use Micron. I find the following very useful:
The Micron page language parser is here:
https://rfnexus.github.io/micron-parser-js/

Example pages in Micron language:
https://codeberg.org/etux/Node_App_Template

[iacore]

Where even is the spec for the Micron markup format?

[brothercorvo]

try the [Micron Composer](https://fr33n0w.github.io/micron-composer/, a web-based, visual editor that makes it easy to create beautifully formatted pages for NomadNet using the Micron markup language. With an intuitive interface, real-time preview, and comprehensive formatting tools, you can create rich, interactive content without memorizing complex syntax.)

[pickles976]

How do you handle user interaction? Let's say I want users to be able to leave comments, how could I accomplish that?

[pickles976]

I was able to figure out how to do it by just feeding a bunch of sources to an LLM and then troubleshooting until I got it working. It's not immediately obvious how actually access the fields and variables from a request link on the backend-- I think that should be added to the documentation. Once I got that figured out, it was pretty straightforward.

https://github.com/pickles976/NomadnetTemplates

Going to try and write a little framework around micron to make it easier to create apps.

[faragher]

Here's how I handled it.

https://github.com/faragher/NomadLand

Please note the repo is archived for a reason, and I don't have the time to support it. It should get you the information you need, though.

[pickles976]

This is super helpful, thanks!

[pickles976]

I went ahead an wrote a mini-framework for generating micron apps. It uses Chicken Scheme so if you're not familiar with Scheme, you will need to learn the syntax, but I think it is ideal for this kind of auto-generation stuff. The source code is also meant to be hosted from nomadnet, so you can bootstrap the entire thing without needing to access the clearnet (still need some Chicken Scheme modules I suppose).

There is a very simple ORM that supports sqlite database generation from a models.scm file, as well as mapping for simple INSERT and SELECT. The ORM does not support foreign keys or anything other than simple datatypes. Honestly the ORM is kind of overkill, you can just use raw SQL instead if you prefer-- I just figured that the sugar would be nice for simple things like comments.

Lastly, there is a (not very good) markdown parser that tries to convert markdown into micron representation. The motivation here is that I could take my markdown docs for the Angstrom framework and render them in micron automatically. In practice the conversion isn't great.

Disclaimer: 90% of this code was written by Claude. I wrote the micron dsl in Scheme and then Claude just chewed through the ORM implementation with some guidance from me on how I wanted the usage syntax to look.

https://github.com/pickles976/Angstrom.git

[pickles976]

I will hopefully get it fully finished this weekend and have it hosted on reticulum, and then I'll add more examples and tutorials to make it easier for people to get started.