simonkoehler/textile

Provides a new Markdown content element and a ViewHelper

Installs: 7

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 1

Type:typo3-cms-extension

1.0.3 2020-07-26 04:15 UTC

This package is auto-updated.

Last update: 2020-11-26 05:26:09 UTC


README

Twitter Follow Donate

Features

  • Provides a new content element of type "Markdown" wich lets you create Textile Markdown language code
  • Provides a handy ViewHelper to use "<f:textile.parse>" in your own extensions!
  • Based on the "Textile" Markdown parser: https://textile-lang.com/
  • Renders shortcodes of internal links to pages!

Screenshots

new-content-element-wizard.jpg?raw=true

content-element-textile.jpg?raw=true

Official documentation:

You will find the official documentation als in German and Spanish here: https://simon-koehler.com/en/products/textile

Installation

Install the extension by downloading it in the extension manager or on https://extensions.typo3.org/extension/textile/.

Basic configuration

If you want to use the Markdown content element:

  • Install the extension
  • Clear caches
  • Include static TypoScript Setup
  • Include Page TS from page properties
  • Create a new content element with the content element wizard

If you want to use the ViewHelper only:

  • Install the extension
  • Clear caches
  • Insert {namespace textile=SIMONKOEHLER\Textile\ViewHelpers} on top of your fluid templates
  • Use the ViewHelper like this: <textile:parse content="{bodytext}"/>

How to insert an internal link

The shortcode function is pretty simple. You can define the page UID of your desired target page, a link title, target and CSS classes. Use the syntax below in your Markdown code:

Simple usage: [link:4]
Full parameters: [link:4:Labeltext:_blank:my-css-class]

Frontend output:

<a href="/yourpageslug/" target="_blank" class="my-css-class">Labeltext</a>

How to use the ViewHelper in a Fluid template

{namespace textile=SIMONKOEHLER\Textile\ViewHelpers}
<!-- Minimal ViewHelper usage -->
<textile:parse content="{bodytext}"/>

<!-- Setting a default link text if a link has no text defined -->
<textile:parse content="{bodytext}" defaultLabel="MyLabel"/>

<!-- Disable rendering of links -->
<textile:parse content="{bodytext}" disableLinks="1"/>

Support & Service

If you have any problems with the extension, please let me know! Since this is open source, I only guarantee 100% expert support when I get paid, but I also like to support the community. Please don't hesitate to open an issue here on GitHub or send a message: https://simon-koehler.com/en/contact

Do you want to learn TYPO3? Here's what you need:

Video Training TYPO3 9 LTS (German language) https://www.digistore24.com/redir/246076/GOCHILLA/