Establishing github page for radiology


(Ivo Ulrich) #1

Hi all!

@judywawira and @sunbiz and myself would like you to create a new website for the radiology project.

This page should show all info related to the radiology project (documentation, maybe later a link to a demo server).

I assume the site could be served at librehealth.io/radiology

Suggestions/input more welcome!

We would need a repository for that site, should that one be on github since currently librehealth.io comes from https://github.com/LibreHealthIO/librehealth.io ? Or gitlab?

@sunbiz can you please link the students working on it to this topic.


(Michael Downey) #2

I have set up a project at https://gitlab.com/librehealth/librehealth-radiology and added @judywawira with master permissions. We can add your account as well if you have one yet.

When we launch the “live” web site we will definitely have a page(s) for each sub-project, and will probably follow the URL syntax you mention. Some other folks are working to set up those GitLab pages for the new web site so I’ll defer to the ones already thinking about that. :slight_smile:


(Ivo Ulrich) #3

just signed in with my github account :slight_smile:

should that repository then contain the source code for the website and the actual modules code? so after each commit static site is generated and pushed to a separate branch.


(Saptarshi Purkayastha) #4

We should be able to get this created through gitlab pages. It support multiple static page generators and I like that the runners are pretty fast. Jekyll is great, but we could do more with Hexo which has a powerful set of plugins.

Using gitlab pages for documentation also works nicely. A few hrs back I was telling @phoenigmatic bout using gitbook to write radiology user stories. @rallam92 has also migrated most issues from JIRA into her repo, that we can move to the librehealth-radiology project. @jayanthkumar17 also said he wants to help, but needs some guidance of where he can contribute to librehealth.


(Jayanth Kumar ) #5

Yup, i would like to give my inputs for the radiology project.


(Ivo Ulrich) #6

@rallam92 and others

What I would like to see for the radiology website is:

A landing/home page which shows:

  • the vision/mission statement (which we should best come up with in its own thread, not here, to keep this thread focused on the page)
  • a link to the documentation (found here https://github.com/teleivo/docs-openmrs-module-radiology ; you might convert the asciidoc into markdown and integrate it into the repo which holds the code for the radiology website)
  • (later) a link to the demo server

I think that would be enough content for now. After the initial setup we will of course evolve its content.

For the looks of the page:

I would love to see a nice radiology logo and a nicely looking page, but Im no designer so the only thing I can help you with here is say I like it or I dont like it :laughing:

Also I wouldnt think to much about this now.

For the logistics/technology:

I like having docs (by docs here I mean the website) and code in one repo. If they are separate it will most likely not be maintained as well.

For static site builders: there are a lot. Can be overwhelming. Ive seen a talk about https://github.com/gatsbyjs/gatsby which is a static site builder for reactjs (built on reactjs). You can see a list of example pages there. But to get started we are probably ok with mostly markdown.

Whatever you choose it will be good enough for our purposes so dont worry :sunny:

Other than that take initiative, feel free to try out different things and have fun!


(Rallam92) #7

Yes, I will start working on the webpage. I will design a basic website according to the details mentioned by you.

Than you


(Robby O'Connor) #8

@teleivo and @rallam92: let me know if you need anything from an infrastructure POV. I am here to ensure our projects get whatever they need.


(Saptarshi Purkayastha) #9

Hi @rallam92, I know you’ve chosen zim, but then it means that you have to write HTML code or use the zim desktop client to write content… Zim is a nice desktop wiki, but with a host of very nice static site generators out today, it is a little old and takes you away from content and haggle with markup. I suggest that you use Jekyll or gatsby (like @teleivo suggest) because these can take Markdown or simple text and transform them into nice looking htmls. Jekyll has a nice community and a large number of new themes are created everyday - http://jekyllthemes.org/.


(Art Eaton) #10

Ruby might be a turn-off with jekyll, so if not zim, why not gitbook? If you are going with gitbook for documentation, it seems a little silly not to use that across the board since it is perfectly capable of generating stylish html.
Personally, I find that the new templatee-page generating modern stuff tends to format a tiny bit of information around a ton of eye-candy.


(Saptarshi Purkayastha) #11

I dont expect anyone to be building the site locally, so I dont think ruby or any else would be a problem. The GitLab shared runners will do all the heavy lifting and site generating. We just need an AsciiDoc/Markdown editor, which GitLab does pretty well at the moment. So edits can be done using the gitlab interface. So all in the browser, nothing locally.

I haven’t seen a lot of good stylesheets for gitbook… and its ToC structure doesn’t lend to the menu system that people are used to when browsing websites

After @teleivo’s recommendation, I did try gatsby… but the local tooling for it and unstable documentation was a lot to dig through. Might be frustrating to deal with since its not stable yet.


(Rallam92) #12

Hello everyone,

I have created website for radiology project. You can find the website at the following link http://roshini.reddy1992.gitlab.io/radiology.librehealth.io/

I would like to have your feedback.

Thank you.


(Robby O'Connor) #13

Can we not be so cliche as to do this…it’s getting old :slight_smile: – Let’s be original!


(Saptarshi Purkayastha) #14

That link you posted is hilarious, but I think @rallam92 is more innovative. The top 4 links open new pages. there is multiple page layouts, if you look on the other parts. It also has a code sharing section that is different from that. It has more than 4 icons too :slight_smile:


(Michael Downey) split this topic #15

5 posts were split to a new topic: Forking/merging into LH-wide website


(David Channin) #16

Noob, here. Not sure at all where to contribute comments about radiology workflow. Please advise.