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%40adobe.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/
