vB5-Manual

Adam

Administrator
Staff member
Jul 15, 2020
750
2
18
Credits
4,025
Points
3,595
About the Project
The vBulletin Documentation project using the flat-file CMS. Grav uses a series of markdown files and templates to present its content. Due to this, most pages of the documentation are viewable in this repository. The site can be viewed in its complete form at the website.

The current vBulletin Manual was built many years ago and has not been updated with new and necessary functionality. It also has a difficult interface to update manuals. Using the Grav system, we can build documentation with a similar hierarchy but include new modern functionality with ease. The Grav CMS is a flatfile CMS without the need for a database. Grav has its own template and caching systems to allow fast rendering of pages. It is also extendible through plugins.

Features Added to the Documentation
  • Responsive. Open the documentation in a separate window or mobile device and it will conform to the screen.
  • Responsive Images - Images adapt automatically to the screen size.
  • Markdown style documentation. This documentation can be downloaded from this project and each page can be read in a text editor if desired.
  • Automatic Indexing - Indexes are provided for each book and the entire site. The system automatically updates the index when a new article is added.
  • Image Galleries. Image Galleries with Lightbox support can be added to articles making it easier to demonstrate steps.
  • Features can be easily designated as vBulletin Cloud friendly.
  • Video Embedding - Allows the author to embed videos in their articles with full playback control.
  • Github Sync - Makes sure the documentation is up to date and "backed up".
Features to be Added
  • PDF Download of specific Books.
Documentation Structure
The vB5 Manual is broken up into different Books, Chapters, and Articles. Each Book covers a specific set of functionality within the vBulletin 5 Suite and is divided into chapters. Chapters are collections of articles that contain the information about individual functions.
30.png

New Installation
  1. Start by creating a directory to hold your copy of the documentation project. This must be in a web accessible directory. I use one called /manual/ within the a vbulletin virtual host. So on my server, the path would be %webroot%/vbulletin/manual. I will use this path in all examples below. In my local browser, I access it via the address http://%webroote%/vbulletin/manual. If you do not have a development server configured for your OS, you will need to do so in order to use this package. If you're using Windows, I recommend .
  2. Download the for the Grav CMS.
  3. Upzip the skeleton package within the directory you created.
  4. Rename user/pages within the Skeleton to /user/pages.bak
  5. Download the master version of this project and unzip it.
  6. Overwrite the files within the Skeleton.
  7. Navigate to the site in your web browser.
Note: Make sure that your webserver can write to the %webroot%/vbulletin/manual/cache and %webroot%/vbulletinmanual/users/data directories.
 
Download link

Attachments

Thread starter Similar threads Forum Replies Date
A vB5-Documentation vBulletin Releases 0
A RCE-VB5.x vBulletin Releases 0
Similar threads