<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<div dir="auto">As I said in my previous email. There is only one example tutorial right now. The first one in the basic category: "basic geometry"
<div dir="auto"><br>
</div>
<div dir="auto">The rest is as you say only a TOC. </div>
<div dir="auto"><br>
</div>
<div dir="auto">I haven't checked readthedocs yet. It may be an option. But I like markdeep for its feature set. </div>
<div dir="auto"><br>
</div>
<div dir="auto">Regards </div>
<div dir="auto">Björn </div>
<div dir="auto"><br>
</div>
<div dir="auto"><br>
</div>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">Den 20 nov. 2017 09:00 skrev michael kapelko <kornerr@gmail.com>:<br type="attribution">
<blockquote class="quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div><font size="2"><span style="font-size:10pt">
<div>Hi.<br>
I can't see any tutorial. It's just a Table Of Contents. I guess at<br>
least one tutorial is necessary to evaluate navigation.<br>
<br>
As a side note, <a href="https://readthedocs.org/">https://readthedocs.org/</a> hosts lots of docs with a<br>
nice navigation, so this might be an option.<br>
<br>
On 20 November 2017 at 00:18, Björn Blissing <bjorn.blissing@vti.se> wrote:<br>
> Hi Robert et al,<br>
><br>
> As said earlier, I have started to experiment with GitHub pages. I discovered that it was hard to support both single-page and multi-page documents using markdeep (since its limited support for included documents). So having a single-page and multi-page document
at the same time will not work unless everything is in a completely flat directory structure, which will be unmaintainable. So I decided to go with a multi-page solution.<br>
><br>
> I have pushed the current work to a personal repo on GitHub. You can checkout the result at:<br>
> <a href="https://bjornblissing.github.io/openscenegraph-tutorials">https://bjornblissing.github.io/openscenegraph-tutorials</a><br>
><br>
> And the corresponding repo is here:<br>
> <a href="https://github.com/bjornblissing/openscenegraph-tutorials">https://github.com/bjornblissing/openscenegraph-tutorials</a><br>
><br>
> So far I have built a test skeleton for tutorials. This includes a draft version of the table of contents and simple introduction tutorial to see if my test is working. I have included a CMakeList.txt file in the root directory which can be used to generate
build files for the tutorials.<br>
><br>
> The only available tutorial as of now is "Basic Geometry".<br>
><br>
> But before I continue with any more work I would like some community feedback. There are many questions that I think should be answered:<br>
><br>
> * Is this a tutorial format worth pursuing?<br>
> * Is Markdeep the right choice?<br>
> * Is CCBY and MIT licenses that should be used for this project?<br>
> * What C++ standard should the source code be written in (my suggestion is C++98 for maximum compatibility)?<br>
><br>
> Note: This should not be seen as anything more than a very rough draft of how tutorials on GitHub pages could look like. If the community agrees that this is the way forward I will continue the work, as well as transfer the repository to the main OpenSceneGraph
GitHub account.<br>
><br>
> Regards,<br>
> Björn<br>
><br>
> ------------------<br>
> Read this topic online here:<br>
> <a href="http://forum.openscenegraph.org/viewtopic.php?p=72416#72416">http://forum.openscenegraph.org/viewtopic.php?p=72416#72416</a><br>
><br>
><br>
><br>
><br>
><br>
> _______________________________________________<br>
> osg-users mailing list<br>
> osg-users@lists.openscenegraph.org<br>
> <a href="http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org">
http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org</a><br>
_______________________________________________<br>
osg-users mailing list<br>
osg-users@lists.openscenegraph.org<br>
<a href="http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org">http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org</a><br>
</div>
</span></font></div>
</blockquote>
</div>
<br>
</div>
</body>
</html>