Create a ns8 repository for developers

stephdl · March 4, 2024, 8:51pm

Disclaimer: this is how to document for developers the way to create their repositories, For now I do not release in a private repository

Hello mates

there are ten years I opened my personal repository and the first things I did was to document the path to reproduce it. Few years later, well in real quite some long years after I was in Brussels and it was the first time that I met @mrmarkuz.

Beside a beer that we were sharing, waiting all the Nethservians team, I pushed markus to open his own repository and I am happy that he did it…my documentation has been used to spread the world about how to make a repository

This is what I would like to offer just a quick way to open your repo for NS8

A developer needs to decide what, when, and how a software must be released

after that you can create the repository by adding https://raw.githubusercontent.com/stephdl/ns8-nethforge/repomd/ns8/updates/

Of course you have to add you own module by adding a PR

this is the files you have to add inside a sogo folder

https://github.com/stephdl/ns8-nethforge/tree/main/sogo

stephdl · March 4, 2024, 8:57pm

to release go to the project repository of the app here ns8-sogo and add a new release with a tag

add a release like 1.0.0 for stable version and 1.0.0-dev.1 for testing version

set the latest release for stable or pre-release for dev

LayLow · March 4, 2024, 9:22pm

As always @stephdl is “Tha Man” with a large community hart!

oneitonitram · March 4, 2024, 9:42pm

how does one define custom domain to this?

I presume a cname to https://raw.githubusercontent.com/stephdl/ns8-nethforge/repomd should work?

stephdl · March 4, 2024, 9:58pm

Reverse proxy or a redirect permanent should do the trick

oneitonitram · March 4, 2024, 10:27pm

i think we would also need to pripritize

As well as

oneitonitram · March 4, 2024, 11:19pm

I think I was Succesful in the endeavour
GenForge modules index for NS8 | ns8-genforge (https://forge.genius.ke/ns8/updates)

Hopefully it would make testing easier for community members.

I ran into this issue when setting up a custom domain
GitHub Pages resets custom domain for deployment every time I push to gh-pages · community · Discussion #22366 · GitHub

Luckily, seems the Neth team also got the same issue, and in the build script, replace the forge.nethserver.org domain with your own to resolve the issue.

stephdl · March 5, 2024, 6:46am

Share the solution please and welcome to your personal repository

dnutan · March 6, 2024, 8:17pm

6 posts were merged into an existing topic: NS8-Paperless NGX Module

oneitonitram · March 6, 2024, 3:12pm

@stephdl could you kindly help me figure out why, no matter what i try to do, Joplin is not listing on my repo at all.

stephdl · March 6, 2024, 8:07pm

Sorry my cristal ball is broken I need some guidance. I do not know where to go

LayLow · March 7, 2024, 4:41am

If you can’t fix it with duct tape, you’re not using enough duct tape!

stephdl · August 15, 2024, 9:50am

if you are lazy and you want to display all modules in your repository

github.com

stephdl/ns8-stephdl/blob/main/createrepo.py#L120


      
          # # list all the folders in the current directory and append the name of all folders to the end of readme.md
          # folders = [f for f in os.listdir('.') if os.path.isdir(f) and not f.startswith('.')]  # list all non-hidden folders in the current directory
          # with open('README.md', 'a') as f:
          #     f.write('\n\n## List of all the modules in this repository\n\n')
          #     for folder in folders:
          #         f.write(f'- {folder}\n')    # append the name of all folders to the end of readme.md
          #     f.write('\n\n')
          #     f.close()
          
          
          with open('repodata.json') as json_file:
              data = json.load(json_file)
              with open('README.md', 'a') as f:
                  # Add project bug tracker link
                  f.write('\n\n## Stephdl bug tracker\n\n')
                  f.write('[Raise a bug](https://github.com/stephdl/dev/issues)\n\n')  # Replace with the actual project link
          
                  # Add table header
                  f.write('## List of all the modules in this repository with their description\n\n')
                  f.write('| Module Name | Description | Code |\n')
                  f.write('|-------------|-------------|----------------|\n')

oneitonitram · August 15, 2024, 9:53am

Ah Steph, where were you when i was creating my listings. this would have saved me hours.

I think i could still repurpose it for my listings, We have 47 Apps, and only like 10 listed

Thanks @stephdl

DO you have any idea, how we can populate the Github Stars automatically as well as seen here

in geniusdynamics/ns8-genforge: GenForge is where you can find extra modules built by the Genius Dynamics and its Employees for NethServer (github.com)

We get them through [GitHub Stars](https://img.shields.io/github/stars/penpot/penpot?style=social)](https://github.com/penpot/penpot)

stephdl · August 15, 2024, 10:01am

I just recently get the need for a private repository, however my job is more to produce code to help than for doing thing I believe.

oneitonitram · August 15, 2024, 10:04am

Yeah I get it, and this will definitely come in Handy for US, and many in the community.
I can see you really took your time to come up with this.

stephdl · August 15, 2024, 10:33am

With python you could replace values inside a string

>>> name = "Jane"
>>> age = 25

>>> f"Hello, {name}! You're {age} years old."
'Hello, Jane! You're 25 years old.'

You could replace the string in the url by the name of the module if the name is relevant from the name of rhe project. It should be