<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Aug 22, 2015 at 5:58 PM, Lubomir I. Ivanov <span dir="ltr"><<a href="mailto:neolit123@gmail.com" target="_blank">neolit123@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class=""><div class="h5">On 22 August 2015 at 17:09, Gehad Elrobey <<a href="mailto:gehadelrobey@gmail.com">gehadelrobey@gmail.com</a>> wrote:<br>
><br>
><br>
> On Fri, Aug 21, 2015 at 9:38 PM, Lubomir I. Ivanov <<a href="mailto:neolit123@gmail.com">neolit123@gmail.com</a>><br>
> wrote:<br>
>><br>
>> On 21 August 2015 at 20:52, Gehad Elrobey <<a href="mailto:gehadelrobey@gmail.com">gehadelrobey@gmail.com</a>> wrote:<br>
>> ><br>
>> ><br>
>> > On Tue, Aug 18, 2015 at 10:06 AM, Lubomir I. Ivanov<br>
>> > <<a href="mailto:neolit123@gmail.com">neolit123@gmail.com</a>><br>
>> > wrote:<br>
>> >><br>
>> >> On 18 August 2015 at 03:51, Gehad Elrobey <<a href="mailto:gehadelrobey@gmail.com">gehadelrobey@gmail.com</a>><br>
>> >> wrote:<br>
>> >> > Hello Lubomir,<br>
>> >> ><br>
>> >> > As I am progressing with the documentation, I want to add description<br>
>> >> > for<br>
>> >> > users willing to write their own templates, so I will need to<br>
>> >> > describe<br>
>> >> > many<br>
>> >> > concepts related to our defined css selectors, Grantlee names, etc.<br>
>> >> > do<br>
>> >> > you<br>
>> >> > think it is relevant to add these details in the user manual? or we<br>
>> >> > better<br>
>> >> > separate it in a special page on subsurface website for example?<br>
>> >> ><br>
>> >><br>
>> >> hello,<br>
>> >> CCing Dirk, just in case he objects with my proposal.<br>
>> >><br>
>> >> i'd say, just add this in the main documentation file for now, but<br>
>> >> please try keeping it short - only listing the Grantlee variables and<br>
>> >> having a brief explaination on how a template works, the CSS etc...<br>
>> >><br>
>> >> i think the manual should be a multi-page HTML at this point instead<br>
>> >> of one file, as it becomes difficult to maintain by multiple users.<br>
>> >><br>
>> ><br>
>> > Hello Lubomir,<br>
>> ><br>
>> > I pushed the latest commits which contains the following updates:<br>
>> ><br>
>> > - Updating the printing section in the user-manual.<br>
>> > - Adding "Appendix F" which describes how to write a custom template as<br>
>> > Dirk<br>
>> > suggested.<br>
>> > - Implemented the code which exports statistics data structures to<br>
>> > Grantlee<br>
>> > backend.<br>
>> > - Make the statistics templates editable (we can also add the<br>
>> > import/export<br>
>> > statistics templates very easily later).<br>
>> > - Fix issue in six dives template.<br>
>> ><br>
>> > I pushed them now as today is the hard deadline for this project in the<br>
>> > scope of GSoC, But I think I will work on additional enhancements before<br>
>> > the<br>
>> > release anyway.<br>
>> ><br>
>><br>
>> nice,<br>
>><br>
>> i will add user-manual comments about typos and such here:<br>
>><br>
>> <a href="https://github.com/Gehadelrobey/subsurface/commit/b0a9596997a57e79e82b47f7c69889ede78d502f" rel="noreferrer" target="_blank">https://github.com/Gehadelrobey/subsurface/commit/b0a9596997a57e79e82b47f7c69889ede78d502f</a><br>
>><br>
>> std::ceil() in printer.cpp throws an error in mingw.<br>
>> just replace all usage of std::ceil() with qCeil() from <QtMath>.<br>
>><br>
>> but please wait for my user-manual comments to be finished before<br>
>> updating your github three.<br>
>> WIP...<br>
>><br>
><br>
> Updates pushed.<br>
><br>
<br>
</div></div>thanks,<br>
will send the PR in a minute.<br>
<br>
can we eventually support HTML/CSS editing of the statistics template,<br>
for instance - adding/removing table columns such as year.avg_depth,<br>
year.max_depth etc?<br>
does that mean we need another Custom.html?<br>
<br></blockquote><div><br>We need to add Custom.html template in printing_templates/statistics, So we can saved edited statistics template there, unless we support in-place editing.<br> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
actually, this opens some questions about the Custom.html<br>
concept...something that i have missed.<br>
<br>
how can the user edit, say the 6-dives template and save it from<br>
Subsurface? it always saves to the Custom.html template and editing in<br>
place is not possible. of course this is nice in a way, as they can't<br>
modify the bundled templates but i think *they should* and it's their<br>
problem if they make one of the bundled templates bad.<br>
<br></blockquote><div><br>I though of this, my solution was that they can always export the custom template into subsurface template directory with the name they prefer and it will be automatically added to the list, Also it is possible to export the template anywhere then import it which will save it to the list.<br> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
editing in-place is the way to go, which means that if the user edits<br>
"Six Dives.html" and presses "save" the actual "Six Dives.html" is<br>
saved - this removes the need for Custom.html.<br>
what do you think? sorry for the late change request, but hopefully<br>
that won't break a lot of things.<br>
<br></blockquote><div><br>I think this will make the user interface more intuitive, but we will not be able to handle overwriting the bundled templates (We can still show a warning message).</div></div><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr">regards,</div></div><blockquote style="margin:0px 0px 0px 40px;border:none;padding:0px"><div><div dir="ltr"><div>Gehad</div></div></div></blockquote></div></div>
</div></div>