Ahh ok you are editing only md files, that's why you are using GitHub straightforward. You can also checkout git repository and make edition locally on your PC. Maybe it would be better even for you.
I see for example that Visual Studio Code have Mark Down helper editor [1] To commiting/pushing and managing repositories I'm using SourceTree [2]. I heard that on Mac there were some issues using it with GitHub two way authentication, but people from the project will help you if you face some of them. Here is some instruction [3]. [1] https://code.visualstudio.com/docs/languages/markdown#_editor-and-preview-synchronization [2] https://www.sourcetreeapp.com/ [3] https://confluence.atlassian.com/sourcetreekb/two-factor-authentication-2fa-with-github-in-sourcetree-402033499.html Piotr 2018-01-22 21:48 GMT+01:00 Andrew Wetmore <[email protected]>: > Hi, Piotr: > > I was not aware that an intermediary tool was available. I am just glaring > straight at Github: > https://github.com/apache/royale-docs/tree/develop/Welcome/Features > > On Mon, Jan 22, 2018 at 4:42 PM, Piotr Zarzycki <[email protected] > > > wrote: > > > Andrew, > > > > What application are you using to manage working with GIT ? > > > > Thanks, Piotr > > > > 2018-01-22 21:37 GMT+01:00 Andrew Wetmore <[email protected]>: > > > > > I see the structure now, and I presume that folders will automatically > be > > > created if I post an .md page that lives in a directory for which there > > is > > > not yet a folder...anyhow, I did not see a way to create a folder. > > > > > > I do not see a "push" option yet. so maybe something is incomplete in > my > > > committer setup. > > > > > > Oh, oh, this is my after-last question for the day: how does the > > structure > > > handle links from one help page to another? Absolute URLs or relative > > URLs? > > > > > > On Mon, Jan 22, 2018 at 3:55 PM, Alex Harui <[email protected]> > > > wrote: > > > > > > > I will be offline a bit over the next few hours. You should be able > to > > > > click on "High Level" and "Features and Concepts" and "AS3" and > "MXML" > > in > > > > the TOC and they should take you to pages deeper in the folder > > structure. > > > > Hopefully you can figure out the pattern and create other files. > > > > For example, the AS3 page has an href in the TOC as > > > > "/Welcome/Features/AS3.html". In the repo, there is a > > > > Welcome/Features/AS3.md. > > > > Jekyll files must have the "Front Matter" in them (the dashed lines > and > > > > the stuff between them). > > > > > > > > Jenkins commit hooks are still not working, so I've had to go log > into > > > > Jenkins, view the project, and hit "Build Now" which generally takes > a > > > few > > > > seconds. I have to refresh the Jenkins page to see that the build > > > passed. > > > > Then in the Jenkins screen there is "Last Successful Artifacts" and > > > > clicking on index.html should get you to the updated landing page. > > > > > > > > I saw you created a PR on GH, but you should now be able to use "git > > > > commit" and "git push" once you've done the GitBox account linking. > > > > > > > > Keep asking questions and maybe consider capturing some of it > somewhere > > > > like our wiki for the next new committer. Looking forward to your > > > > contributions. > > > > > > > > -Alex > > > > > > > > > > > > On 1/22/18, 11:45 AM, "Andrew Wetmore" <[email protected]> wrote: > > > > > > > > >I think I am allowed one more idiot question for the afternoon: > let's > > > say > > > > >I > > > > >create an .md file with the correct name to match an entry in the > ToC. > > > > >Where do I add it? > > > > > > > > > >On Mon, Jan 22, 2018 at 3:30 PM, Alex Harui > <[email protected] > > > > > > > >wrote: > > > > > > > > > >> Yes. Jekyll takes the .MD files and creates a folder _site with > the > > > > >>same > > > > >> folder structure, but with HTML instead of MD. The HTML is > > generated > > > > >>via > > > > >> the layout(s) in _layout. There is currently only one layout > > > > >> (docpage.html); It is those HTML files that will be deployed. > > > > >> > > > > >> I'm screwing around with docpage.html and royalesite.css right > now. > > > > >> > > > > >> -Alex > > > > >> > > > > >> On 1/22/18, 11:26 AM, "Andrew Wetmore" <[email protected]> > wrote: > > > > >> > > > > >> >So...all the entries in the doc ToC point to .html locations. Are > > we > > > > >> >creating .md pages that automagically convert? Where do we put > them > > > in > > > > >>the > > > > >> >file structure? > > > > >> > > > > > >> >On Mon, Jan 22, 2018 at 3:15 PM, Andrew Wetmore < > > [email protected] > > > > > > > > >> >wrote: > > > > >> > > > > > >> >> And there we are! > > > > >> >> > > > > >> >> On Mon, Jan 22, 2018 at 3:12 PM, OmPrakash Muppirala > > > > >> >><[email protected] > > > > >> >> > wrote: > > > > >> >> > > > > >> >>> I believe you need to switch to the `develop` branch. > > > > >> >>> > > > > >> >>> Thanks, > > > > >> >>> Om > > > > >> >>> > > > > >> >>> On Mon, Jan 22, 2018 at 11:11 AM, Andrew Wetmore > > > > >><[email protected]> > > > > >> >>> wrote: > > > > >> >>> > > > > >> >>> > I do not see anything there that relates to the demo you did > > > > >>showing > > > > >> >>>the > > > > >> >>> > ToC for the help documentation. I see two .md pages, just > > > > >> >>>placeholders. > > > > >> >>> > docpage.html in _layouts seems to just be the code for the > > > Royale > > > > >> >>>main > > > > >> >>> > page. > > > > >> >>> > > > > > >> >>> > On Mon, Jan 22, 2018 at 3:06 PM, Alex Harui > > > > >> >>><[email protected]> > > > > >> >>> > wrote: > > > > >> >>> > > > > > >> >>> > > Here it is again. > > > > >> >>> > > > > > > >> >>> > > Github Project: > > > > >> >>> > > > > > > >> > > > > >>>>>https://na01.safelinks.protection.outlook.com/?url= > > > > https%3A%2F%2Fgithu > > > > >>>>>b > > > > >> . > > > > >> >>>com%2Fapache%2Froyale-docs&data=02%7C01%7Caharui%40adobe.com > > > > >> %7C1fa559ca8 > > > > >> >>>2954c005a7b08d561ce0a34%7Cfa7b1b5a7b34438794aed2c178de > > > > >> cee1%7C0%7C0%7C636 > > > > >> >>>522460151866211&sdata=Uk%2FcldWkIaL3UIWdtHNGh4yyfeDWrTd > > > > >> pO5yguGwJfnc%3D&r > > > > >> >>>eserved=0 > > > > >> >>> > > > > > > >> >>> > > Clone URL: > > > > >> >>> > > > > > > >> > > > > >>>>>https://na01.safelinks.protection.outlook.com/?url= > > > > https%3A%2F%2Fgithu > > > > >>>>>b > > > > >> . > > > > >> >>>com%2Fapache%2Froyale-docs.git&data=02%7C01%7Caharui%40ad > obe.com > > > > >> %7C1fa55 > > > > >> >>>9ca82954c005a7b08d561ce0a34%7Cfa7b1b5a7b34438794aed2c178de > > > > >> cee1%7C0%7C0%7 > > > > >> >>>C636522460151866211&sdata=slX6qJ0Ox9AO% > > > > 2BHgCGRpRGxgWWKHi2LgyW2jA6cTl5 > > > > >> kA% > > > > >> >>>3D&reserved=0 > > > > >> >>> > > > > > > >> >>> > > HTH, > > > > >> >>> > > -Alex > > > > >> >>> > > > > > > >> >>> > > On 1/22/18, 11:02 AM, "Andrew Wetmore" < > [email protected] > > > > > > > >> wrote: > > > > >> >>> > > > > > > >> >>> > > >Sorry to be so dense, but I do not see where to find the > > > > >> >>> documentation > > > > >> >>> > > >project so I can add pages, edit pages, or update the > ToC. > > > The > > > > >> >>>links > > > > >> >>> in > > > > >> >>> > > >Alex's most recent post do not seem to work for me, even > > > when I > > > > >> >>>edit > > > > >> >>> out > > > > >> >>> > > >the errant "_" that I think my email client inserted at > the > > > > >>line > > > > >> >>> break. > > > > >> >>> > > > > > > > >> >>> > > > > > > > >> >>> > > > > > > > >> >>> > > >-- > > > > >> >>> > > >Andrew Wetmore > > > > >> >>> > > > > > > > >> >>> > > >https://na01.safelinks.protection.outlook.com/?url= > > > > >> >>> > http%3A%2F%2Fcottage14 > > > > >> >>> > > . > > > > >> >>> > > >blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com% > > > > >> >>> > > 7Cedd87f7519af4988b4ab08 > > > > >> >>> > > >d561cabe57%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0% > > > > >> >>> > > 7C636522445767082385 > > > > >> >>> > > > > > > >>>&sdata=nqzEGEr5QPGcMyugWDqZeisV6rkdQdlUA3YdNor2gq4%3D&reserved=0 > > > > >> >>> > > > > > > >> >>> > > > > > > >> >>> > > > > > >> >>> > > > > > >> >>> > -- > > > > >> >>> > Andrew Wetmore > > > > >> >>> > > > > > >> >>> > > > > > >> >>>https://na01.safelinks.protection.outlook.com/?url= > > > > >> http%3A%2F%2Fcottage1 > > > > >> >>>4.blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com% > > > > >> 7C1fa559ca82954c005a > > > > >> >>>7b08d561ce0a34%7Cfa7b1b5a7b34438794aed2c178de > > > > >> cee1%7C0%7C0%7C636522460151 > > > > >> >>>866211&sdata=5%2BpDWiUEEIuGr2R0mCq18uino1% > > > > >> 2BfKXSXym3tDs0xedY%3D&reserved > > > > >> >>>=0 > > > > >> >>> > > > > > >> >>> > > > > >> >> > > > > >> >> > > > > >> >> > > > > >> >> -- > > > > >> >> Andrew Wetmore > > > > >> >> > > > > >> >> > > > > >> >>https://na01.safelinks.protection.outlook.com/?url= > > > > >> http%3A%2F%2Fcottage14 > > > > >> >>.blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com% > > > > >> 7C1fa559ca82954c005a7b > > > > >> >>08d561ce0a34%7Cfa7b1b5a7b34438794aed2c178de > > > > >> cee1%7C0%7C0%7C636522460151866 > > > > >> > > > > >>>>211&sdata=5%2BpDWiUEEIuGr2R0mCq18uino1%2BfKXSXym3tDs0xedY%3D& > > > > reserved=0 > > > > >> >> > > > > >> >> > > > > >> >> > > > > >> >> > > > > >> >> > > > > >> > > > > > >> > > > > > >> >-- > > > > >> >Andrew Wetmore > > > > >> > > > > > >> > > > > >>>https://na01.safelinks.protection.outlook.com/?url= > > > > http%3A%2F%2Fcottage1 > > > > >>>4 > > > > >> . > > > > >> >blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com% > > > > >> 7C1fa559ca82954c005a7b08 > > > > >> >d561ce0a34%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0% > > > > >> 7C636522460151866211 > > > > >> >&sdata=5%2BpDWiUEEIuGr2R0mCq18uino1%2BfKXSXym3tDs0xedY%3D& > > reserved=0 > > > > >> > > > > >> > > > > > > > > > > > > > > >-- > > > > >Andrew Wetmore > > > > > > > > > >https://na01.safelinks.protection.outlook.com/?url= > > > http%3A%2F%2Fcottage14 > > > > . > > > > >blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com% > > > > 7Cb83b089eb4fc43396cf208 > > > > >d561d0b10a%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0% > > > > 7C636522471332689971 > > > > >&sdata=xtxdhRtUkVEY%2FYCVOr%2B2sWZRbMr8tSNum8C9F6EyoSM%3D& > reserved=0 > > > > > > > > > > > > > > > > > -- > > > Andrew Wetmore > > > > > > http://cottage14.blogspot.com/ > > > > > > > > > > > -- > > > > Piotr Zarzycki > > > > Patreon: *https://www.patreon.com/piotrzarzycki > > <https://www.patreon.com/piotrzarzycki>* > > > > > > -- > Andrew Wetmore > > http://cottage14.blogspot.com/ > -- Piotr Zarzycki Patreon: *https://www.patreon.com/piotrzarzycki <https://www.patreon.com/piotrzarzycki>*
