Git Product home page Git Product logo

doc's Introduction

TYPO3 Extension doc

This extension adds an option to the Help menu called Project Documentation, that lets you deliver documentation about your project from within TYPO3 CMS backend.

Help

The extension also ships with a widget for the TYPO3 Dashboad extension to give you quick access to your project documentation.

Widget

The documentation is based on Markdown. This makes it easy to write documentation while you're building a custom extension, or afterward. You could include descriptions of content elements, release notes, instructions for raising issues or anything else that needs to be documented.

The JS library docsify transforms markdown files into beautiful HTML content.

Demo

Setup the extension

Download the extension. Use one of the following options:

  1. Composer: composer req georgringer/doc
  2. TER: Download extension from TER
  3. TYPO3 Backend: Download extension in Extension Manager

Configuration

Switch to Install Tool/Settings and customize the global configuration. As seen in the screenshot below, the following configuration options are available:

  • Documentation Root Path: Define the path to the Markdown files
  • Documentation Name: Documentation name as it appears in the sidebar
  • Dark mode: Enable the dark mode

Extension Configuration

Write the documentation

Without any documentation, this extension is not useful at all :)

Check out the sample documentation included in this extension which you can use as a guide EXT:doc/Resources/Private/ExampleDocs. See also the Markdown Cheatsheet as there are some nice features available.

When you create your own documentation make sure to put the folder with your markdown files in Resources/Private. Otherwise your markdown files may be publicly accessible.

doc's People

Contributors

georgringer avatar peterkraume avatar flicstar avatar rathch avatar

Forkers

format-gmbh

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.