aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew Manning <tamanning@zoho.com>2016-12-08 21:41:04 -0500
committerAndrew Manning <tamanning@zoho.com>2016-12-08 21:41:04 -0500
commitcafa5217ed3824c142b44b8b8e5bcb484ffea6fe (patch)
tree1a4a57b201c189dbac3bf5fd25c148015fe7e871
parentbc16a1bcc4a5f58df2f8994cd53661c8f53acab5 (diff)
downloadvolse-hubzilla-cafa5217ed3824c142b44b8b8e5bcb484ffea6fe.tar.gz
volse-hubzilla-cafa5217ed3824c142b44b8b8e5bcb484ffea6fe.tar.bz2
volse-hubzilla-cafa5217ed3824c142b44b8b8e5bcb484ffea6fe.zip
Condense sticky nav TOC to h1 only. Add deep TOC to top of each page. Adjust developer guide headings.
-rw-r--r--doc/developer/developer_guide.md20
-rw-r--r--doc/toc.html2
-rw-r--r--view/tpl/help.tpl14
3 files changed, 25 insertions, 11 deletions
diff --git a/doc/developer/developer_guide.md b/doc/developer/developer_guide.md
index 3c0f7294d..7ec76714f 100644
--- a/doc/developer/developer_guide.md
+++ b/doc/developer/developer_guide.md
@@ -1,4 +1,4 @@
-## Who is a Hubzilla developer? Should I read this?
+# Who is a Hubzilla developer? Should I read this?
Anyone who contributes to making Hubzilla better is a developer. There are many different and important ways you can contribute to this amazing technology, _even if you do not know how to write code_. The software itself is only a part of the Hubzilla project. You can contribute by
@@ -11,31 +11,31 @@ _Software_ developers are of course welcomed; there are so many great ideas to i
This document will help you get started learning and contributing to Hubzilla.
-## Versioning system
+# Versioning system
The versioning system is similar to the popular semantic versioning but less stringent. Given x.y.z, x changes yearly. y changes for "stable" monthly builds, and z increments when there are interface changes. We maintain our date and build numbers for medium grain version control (commits within a certain date range) and of course git revs for fine grained control.
-## Git repository branches
+# Git repository branches
There are two official branches of the Hubzilla git repo.
* The stable version is maintained on the **master** branch. The latest commit in this branch is considered to be suitable for production hubs.
* Experimental development occurs on the **dev** branch, which is merged into **master** when it is deemed tested and stable enough.
-## Developer tools and workflows
+# Developer tools and workflows
-### Hub Snapshots
+## Hub Snapshots
The [[Hub Snapshots]] page provides instructions and scripts for taking complete
snapshots of a hub to support switching between consistent and completely known
states. This is useful to prevent situations where the content or database schema
might be incompatible with the code.
-## Translations
+# Translations
Our translations are managed through Transifex. If you wish to help out translating Hubzilla to another language, sign up on transifex.com, visit [https://www.transifex.com/projects/p/red-matrix/](https://www.transifex.com/projects/p/red-matrix/) and request to join one of the existing language teams or create a new one. Notify one of the core developers when you have a translation update which requires merging, or ask about merging it yourself if you're comfortable with git and PHP. We have a string file called 'messages.po' which is gettext compliant and a handful of email templates, and from there we automatically generate the application's language files.
-### Translation Process
+## Translation Process
The strings used in the UI of Hubzilla is translated at [Transifex][1] and then
included in the git repository at github. If you want to help with translation
@@ -98,7 +98,7 @@ view/de/hmessages.po you would do the following.
repository, push it to your fork of the Hubzilla repository at github and
issue a pull request for that commit.
-### Utilities
+## Utilities
Additional to the po2php script there are some more utilities for translation
in the "util" directory of the Hubzilla source tree. If you only want to
@@ -108,7 +108,7 @@ works.
For further information see the utils/README file.
-### Known Problems
+## Known Problems
* Hubzilla uses the language setting of the visitors browser to determain the
language for the UI. Most of the time this works, but there are some known
@@ -116,7 +116,7 @@ For further information see the utils/README file.
* the early translations are based on the friendica translations, if you
some rough translations please let us know or fix them at Transifex.
-## To-be-organized information
+# To-be-organized information
**Here is how you can join us.**
diff --git a/doc/toc.html b/doc/toc.html
index 64eb93435..a2ebea318 100644
--- a/doc/toc.html
+++ b/doc/toc.html
@@ -417,7 +417,7 @@
if(pageName === linkName) {
var tocUl = $(this).closest('li').append('<ul>').find('ul');
tocUl.removeClass(); // Classes are automatically added to <ul> elements by something else
- tocUl.toc({content: "#doco-content", headings: "h1,h2"});
+ tocUl.toc({content: "#doco-content", headings: "h1"});
tocUl.addClass('toc-content');
if( $(window).height() > 499) {
tocUl.sticky({topSpacing:$('nav').outerHeight(true), zIndex: 1000});
diff --git a/view/tpl/help.tpl b/view/tpl/help.tpl
index 96d52e0e9..2faaa3853 100644
--- a/view/tpl/help.tpl
+++ b/view/tpl/help.tpl
@@ -3,6 +3,20 @@
<h2>{{$title}}</h2>
</div>
<div class="section-content-wrapper" id="doco-content">
+ <h1>Contents</h1>
+ <ul id="doco-top-toc"></ul>
+ <hr>
{{$content}}
</div>
</div>
+
+<script>
+
+ // Generate the table of contents in the side nav menu (see view/tpl/help.tpl)
+ $(document).ready(function () {
+
+ $('#doco-top-toc').toc({content: "#doco-content", headings: "h1,h2,h3,h4"});
+
+ });
+
+</script> \ No newline at end of file