In the proof of concept I made yesterday, I used the raw links to the .md files which works perfectly. When you go to any file on GitHub, there’s a ‘raw’ button which will show you the raw content of the file. Then just copy the link and you can use that one wherever you like. An example here [1] It’s just a hyperlink so I don’t think there’s any limitation here. The only thing we have to do is to parse the markdown content into html but there are plenty of js libs on npm to do that, so we wouldn’t have to write it ourselves.
Dany [1] https://raw.githubusercontent.com/apache/royale-docs/master/index.md > Op 5 mei 2019, om 16:49 heeft Carlos Rovira <[email protected]> het > volgende geschreven: > > Hi Danny, > > One question about the workflow: the new doc page viewer, will be a royale > app that retrieve the GitHub content on demand, in the same way as I did in > TDJ with source code? Will do this on demand? If we can do in that way, not > saving new files to repo, I think that would be great, since viewer will > pick fresh content each time. Maybe this could face some limitation of the > Github Rest API (don't know how many petitions it will allow per hour or > day) > > If we do in this way, we can reuse part of the code in TDJ and the main > problem will be to create the Sticky menu on the Right. That as well could > be based on current Navigator component. I could create that component as > part of Jewel. > > So having a main content part and the right stick menu with the ability to > load content as we select on the main content part, will be the "engine" we > need > Then we and others could help with the generation of "stories" to fill the > content. > > Thoughts? > > > El dom., 5 may. 2019 a las 12:23, Dany Dhondt (<[email protected]>) > escribió: > >> HI, >> >> I’d like to propose a project to re-implement the docs. >> >> The project would consist of two parts: >> >> 1. Build a Royale webpage that consists of a ‘doc page viewer’ to the left >> and a sticky toc content list on the right. >> The content is pulled out from our docs repo on GitHub using this basic >> scheme [1] >> The page would then be integrated into our WP site so the user doesn’t get >> pulled away from the main site. >> The look and feel would be identical to the main site too. >> >> 2. Re-arrange and extend the doc pages into more encapsulated ’stories’. >> Every story has a distinct beginning and end and covers one major part of >> Royale’s workflow. >> I don’t know what’s the best way to do this. I don’t want to mess up what >> exists so should I make a new folder inside the current repo to put the >> stories? >> All stories should off course be agreed upon before they get published. >> >> I will do this work in cooperation with Carlos. >> Carlos and me would also be working on extending TourDeJewel >> >> Thoughts? >> >> Dany >> >> >> >> >> [1] https://drive.google.com/open?id=1BwAEnTFnGf5k-hjvp1XUSdBdO2viALd2 > > > > -- > Carlos Rovira > http://about.me/carlosrovira
