Creating a Table of Contents for a web-tutorial?

Permalink
Good morning all,

I am looking to move our PDF tutorials online and want to take that content and make it easy to navigate. I am looking to create a table of contents at the beginning of each tutorial (and maybe a live master listing of all tutorials. Does anyone know how to make table on contents for users?

I am looking into lists and topics, but haven't gone real far down that path. I would consider Express also. However, I would like the process to be fairly simple for the people entering the data for these tutorials. I would rather them not have to go into the dashboard to create table structures, page types, attribute types and topic trees if possible (If not, then I guess that's what we need to do).

Thanks for any info.
THanks

View Replies: View Best Answer
PineCreativeLabs replied on at Permalink Reply
PineCreativeLabs
You could use the core FAQ block to create something along the lines of what you're talking about. If you're a developer, you could create a custom template for it to make it more user-friendly. Or, if you're a developer, here is a list of some jquery table of contents plugins:
https://www.jqueryscript.net/blog/best-table-contents-plugins.html...

I'm thinking I could create a Table of Contents addon. Basically, it would be an enhanced version of the core FAQ block.
bayleafmedia replied on at Permalink Reply
I'll take a look at the FAQ block.

What I'd prefer is for a block that auto-creates a table of contents based on the content. Maybe it would use the Custom ID value for each content block or area to pull and display that content from a page:

example:
ToC settings:
Title: fillable field
Title size: selectable drop down
Desired Custom ID: fillable field

Title: How to build a treehouse
Title Size: H3
Desired Custom ID: ToC

Content topic title 1.
Title: Buy wood
Title Size: H4
Custom ID (from "Edit Area Design" or "Design & Block Template" functions): ToC

Then I would add a text block I guess under that for content.


I don't think that would work the same way as the FAQ function. I personally need the ability to use layouts in our content where the text editer doesn't really seem to support multiple columns responsively (unless you count tables... which still isn't responsive).

thanks for some ideas.
radeff replied on at Permalink Best Answer Reply
radeff
https://github.com/Jozzeh/block_webhapp_toc works well
bayleafmedia replied on at Permalink Reply 1 Attachment
I thought I'd take a quick peek at this, but it wouldn't install.
radeff replied on at Permalink Reply
radeff
you have to install it manually as it is not in the market place
see bottom ofhttps://www.concrete5.org/marketplace/how_to_install_add_ons_and_the...
bayleafmedia replied on at Permalink Reply
Thanks, yes. I should have mentioned I added an attachment. I went through the manual install process and the extendC5 dashboard element listed the plug-in, but said it was not installable.

I've attempted to change the name of the folder that decompresses and that the block is contained in to match what is in controller.php (webhapp_toc), and while it becomes available for install doing this, I receive the following error upon clicking the install button.

"Unable to install webhapp_toc. Please check that this package has been updated for 5.7."

Thanks
bayleafmedia replied on at Permalink Reply
I appreciate everyone's help. I may go ultimately another route, but after renaming to add-on folder for the mentioned add-on to

"webhapp_toc"

I was able to install the it and it creates a ToC based on content in my pages just as I was looking for. Can't believe I overlooked the underscore in the name in the controller file :).

Thanks again for the suggestion.
JohntheFish replied on at Permalink Reply
JohntheFish
Are you converting the PDF tutorials to c5 pages? Or uploading the pdf as files and then providing an index to download them?

A TOC can be implemented as a custom autonav template or PageList template for pages, or a custom template for a DocumentLibrary list for PDF files.

In either case you would use Page or File attributes to tag the pages or files and to assist filtering and sorting.
bayleafmedia replied on at Permalink Reply
Thanks John,

I am looking to take the content out of the PDFs and build out the pages rather than simply uploading and providing a PDF repository. Some of these tutorials will likely begin life as an upload, but over time would change to a fully editable web page.

Thanks I'll look into these ideas, too.
bayleafmedia replied on at Permalink Reply
Thanks again John,

I will likely go this route for making a master listings of tutorials.

-Me