simonkoehler / textile
Provides a new Markup Code content element and a ViewHelper
Installs: 54
Dependents: 1
Suggesters: 0
Security: 0
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 1
Type:typo3-cms-extension
Requires
- typo3/cms-core: ^9.5 || ^10.4
Replaces
- simonkoehler/textile: 1.0.3
- typo3-ter/textile: 1.0.3
README
Features
- Provides a new content element of type "Markup" wich lets you create Textile Markup language code
- Provides a handy ViewHelper to use "<f:textile.parse>" in your own extensions!
- Based on the "Textile" Markup parser: https://textile-lang.com/
- Renders shortcodes of internal links to pages!
Screenshots
Official documentation:
You will find the official documentation als in German and Spanish here: https://simon-koehler.com/products/typo3-extensions/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 Markup 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 Markup 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/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/