Figure 1 - HibbittsDesign.ORG Mastodon Page
I’ve been pretty pleased with how Mastodon is shaping up as a means to post to the Fediverse, so I’ve decided to only post there for now - you can find me on Mastodon at https://mastodon.social/@hibbittsdesign.
]]>Rejected proposal to the 2023 Open Education Conference.
Abstract
Are you interested in leveraging the system-independent format of Markdown for online OER content without any website setup or build process? How about seamlessly embedding constraint-free Markdown/HTML into multiple platforms (e.g. LMS or CMS)? The open-source project Docsify-This.net (based on Docsify.js.org) provides an easy on-ramp to publishing, sharing and reusing open Markdown content!
With Docsify-This you can instantly turn any publicly available Markdown file into a responsive standalone web page, and multiple Markdown files can even be linked together to provide a simple website. The visual appearance of displayed pages can be altered by using the point-and-click Web Page Builder or URL parameters. In addition, if GitHub or Codeberg are used to store Markdown files an “Edit this Page” link can be automatically provided for each page to support collaborative authoring.
Learning Outcomes
Want to get more frequent updates about my current projects and work? You can find me on Mastodon at https://mastodon.social/@hibbittsdesign.
]]>Docsify-This.net version 1.5.3 is now available. The main highlight of this release is improvements to the Web app UI, featuring an updated page banner (now with the Docsify logo).
Figure 1 - Docsify-This Web app
Want to get more frequent updates about my current projects and work? You can find me on Mastodon at https://mastodon.social/@hibbittsdesign.
]]>Docsify-This.net version 1.5 is now available. Highlights include:
✅ Support for dark mode via optional URL parameter (dark-mode
), activation based on system OS-level setting
✅ Support for Wikilinks, as used by #Obsidian
✅ Addition of line height option in the Web Page Builder as an optional URL parameter (line-height
)
✅ Addition of page Browser tab title in the Web Page Builder as an optional URL parameter (title
)
✅ Addition of Open Sans font choice (default Sakai LMS font)
Figure 1 - Docsify-This Web app in dark mode.
Figure 2 - Docsify-This one page article in dark mode.
Let’s review the steps to go from a GitHub Markdown file to a web page with Docsify-This:
What Problem Does Docsify-This Solve?
Docsify-This provides an easy way to publish and share # Markdown content, with no website setup or build process required. Collaborative authoring using GitHub is also supported.
With Docsify-This you can:
Want to get more frequent updates about my current projects and work? You can find me on Mastodon at https://mastodon.social/@hibbittsdesign.
]]>Docsify-This.net version 1.3 is now available. Highlights include support for #Markdown footnotes (with thanks and appreciation to GitHub user sy-records), two Docsify-This Markdown templates and further use of local assets for tracker-free rendering when displaying standard Markdown files (thanks for the valuable input @mandrasch@social.tchncs.de).
Figure 1 - Docsify-This Web app
Figure 2 - Docsify-This one page course template.
Figure 3 - Docsify-This one page article template.
Figure 4 - GitHub Markdown file of Docsify-This one page article template.
Let’s review the steps to go from a GitHub Markdown file to a web page with Docsify-This:
The Docsify-This open source project might just now be the easiest way to turn a GitHub Markdown file into a simple web page (and begin to benefit from the possibilities of a Markdown publishing workflow)!
]]>Docsify-This.net version 1.2.2 is now available. Highlights include support for page annotation using Hypothes.is and improved responsive rendering of embedded H5P content.
Figure 1 - Docsify-This Web app
Figure 2 - Docsify-This Web app with option to enable Hypothes.is
Figure 3 - Markdown file displayed as a Web page with Hypothes.is enabled
Figure 4 - Markdown file displayed as a Web page with responsive H5P content embedded
Let’s review the steps to go from a GitHub Markdown file to a web page with Docsify-This:
The Docsify-This open source project might just now be the easiest way to turn a GitHub Markdown file into a simple web page (and begin to benefit from the possibilities of a Markdown publishing workflow)!
]]>Docsify-This.net version 1.2.1 is now available, with an improved page layout selector (including visual previews), a color preview area next to the link color hexcode field, and with special thanks to the respective Docsify Plugin authors KaTeX (mathematical equations) + Mermaid Diagrams support, both of which are provided with the GitHub Markdown editor.
Figure 1 - Docsify-This Web app
Let’s review the steps to go from a GitHub Markdown file to a web page with Docsify-This:
The Docsify-This open source project might just now be the easiest way to turn a GitHub Markdown file into a simple web page (and begin to benefit from the possibilities of a Markdown publishing workflow)!
]]>🎉Version 1.0 Released🎉
The Docsify-This project gives tech-curious educators and open publishers the ability to display #Markdown files as web pages in seconds. Leverage Markdown content and workflows without needing to set up a website.
Figure 1 - Docsify-This Web app
Give it a go at https://docsify-this.net with your own Markdown files stored on GitHub or publicly available elsewhere, or join me nerding-out a bit with the following examples.
Docsify Open Publishing Starter Kit GitHub README file:
https://github.com/hibbitts-design/docsify-open-publishing-starter-kit/blob/main/README.md
Displayed as a Standalone page with Table of Contents:
https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-open-publishing-starter-kit/main&toc=true
Displayed as a Standalone page with Table of Contents and an ‘Edit this Page’ on GitHub link at the top of the page:
https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-open-publishing-starter-kit/main&toc=true&edit-link=https://github.com/hibbitts-design/docsify-open-publishing-starter-kit/blob/main/README.md&edit-link-top=true
By displaying a Markdown file as a standalone Web page, Docsify-This also provides a great way to embed open content into other platforms and tools - such as #CanvasLMS, #Moodle, #MSTeams etc. For example, here is my #SFU CMPT-363 Canvas site using Markdown content via Docsify-This:
https://canvas.sfu.ca/courses/69678
You can change the default link color and font family to better match your platform of choice and embedded Docsify-This content - and even choose to hide the Docsify-This credit statement at the bottom of the page, for example:
https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-open-course-starter-kit/main/docs&homepage=resources.md&link-color=CC0000&font-family=Helvetica,Arial,sans-serif&hide-credits=true
As a more complex example, here is a collection of Markdown files stored in a single GitHub repository, presented as a multiple page website:
https://docsify-this.net/?basePath=https://raw.githubusercontent.com/nicolas-van/easy-markdown-to-github-pages/master&toc=true&edit-link=https://github.com/nicolas-van/easy-markdown-to-github-pages/blob/master/README.md&edit-link-top=true
And all of this is done with Markdown files stored on GitHub, under your full ownership and control, and presented by Docsify-This🚀 #OER #Markdown #educators #publishing #github
]]>It’s officially official! I’ve just made public preview available of my open source Docsify-This project, which provides tech-savvy educators and open publishers a quick way to display Markdown files as standalone Web pages without needing to setup your own Docsify site🎉
Figure 1 - Docsify-This Web app
Give it a go at https://docsify-this.net with your own hosted Markdown files, or join me nerding-out a bit with some examples.
Docsify Open Publishing Starter Kit GitHub README file:
https://github.com/hibbitts-design/docsify-open-course-starter-kit/blob/main/README.md
Raw Markdown file URL:
https://raw.githubusercontent.com/hibbitts-design/docsify-open-course-starter-kit/main/README.md
Displayed as a Standalone page:
https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-open-course-starter-kit/main/#/
Displayed as a Standalone page with Table of Contents:
https://docsify-this.net/?basePath=https://raw.githubusercontent.com/hibbitts-design/docsify-open-course-starter-kit/main/&toc=true#/
By displaying a Markdown file as a standalone Web page, http://docsify-this.net also provides a great way to embed open content into other platforms and tools - such as Canvas LMS, Moodle, MSTeams etc.
As a more complex example, here is a university course web site stored on GitHub and displayed as a single page.
CPT-363 User Interface Design GitHub README file:
https://github.com/paulhibbitts/cpt-363-user-interface-design/blob/main/README.md
Raw Markdown file URL:
https://raw.githubusercontent.com/paulhibbitts/cpt-363-user-interface-design/main/README.md
Displayed as a Standalone page, with Table of Contents:
https://docsify-this.net/?basePath=https://raw.githubusercontent.com/paulhibbitts/cpt-363-user-interface-design/main/&toc=true#/
And all of this is done by a single Markdown file and Docsify-This🚀
]]>Recently I tweeted about a new experiment to provide people a way to render public Markdown files using Docsify, without needing to setup their own Docsify instance, and I thought I would share them here:
Inspired by @cogdog using Docsify to render multiple project READMEs, made possible by Beau Shaw's original Remote Docsify example, I've just created https://t.co/iZMjgx5GRo where you can use one GitHub Pages site to render remote Markdown files as single Web pages with Docsify👀
— Hibbitts Design (@hibbittsdesign) June 29, 2022
So, for example, to render the file:https://t.co/IC21tkQ84H
— Hibbitts Design (@hibbittsdesign) June 29, 2022
as a standalone Webpage would use the URL (README is the expected default name):https://t.co/xqRL4pdQks
and to also include a Page Table of Contents you would use the URL:https://t.co/dlyu2IUQhe
]]>The template that was used to create this project, Docsify Open Publishing Starter Kit Remote, is also available to clone and use with your own GitHub Pages account so you can further customize the page presentation🚀 https://t.co/Q44Q9mdeVO
— Hibbitts Design (@hibbittsdesign) June 29, 2022