• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

JonasDoebertin/kirby-visual-markdown: Visual Markdown Editor for Kirby CMS 2

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

JonasDoebertin/kirby-visual-markdown

开源软件地址(OpenSource Url):

https://github.com/JonasDoebertin/kirby-visual-markdown

开源编程语言(OpenSource Language):

JavaScript 41.7%

开源软件介绍(OpenSource Introduction):

Visual Markdown Editor for Kirby

Based on CodeMirror. Inspired by MirrorMark.

Release Issues License Moral License

This Panel field plugin for Kirby 2 enables you to use an intuitive and visual markdown editor without any hazzle. Just drop in the plugin and you're good to go!

Screenshot

Important Note (Please Read)

Generally, this extension is free to use on both personal and commercial Kirby powered sites. You don't have to pay for it. However, please always keep in mind that developing this extension took place in my spare time (and maybe a little bit of the time I should have spend on other work related stuff) and up until now, quite some hours have been spent on it..

If you like what I'm doing for the community and you want to support further development of this and future extensions & plugins for Kirby CMS, please consider purchasing a moral license.

This is especially appreciated whenever you use one of the extensions in a project that you get payed for.

Cheers, Jonas

Requirements

  • Kirby 2.2 or above
  • PHP 5.4 or above

Installation

Copy & Pasting

If not already existing, add a new fields folder to your site directory. Then copy or link this repositories whole content in a new markdown folder there. Afterwards, your directory structure should look similar to this:

site/
	fields/
		markdown/
			assets/
			markdown.php

Git Submodule

If you are an advanced user and know your way around Git and you already use Git to manage you project, you can make updating this field extension to newer releases a breeze by adding it as a Git submodule.

$ cd your/project/root
$ git submodule add https://github.com/JonasDoebertin/kirby-visual-markdown.git site/fields/markdown

Updating all your Git submodules (eg. the Kirby core modules and any extensions added as submodules) to their latest version, all you need to do is to run these two Git commands.

$ cd your/project/root
$ git submodule foreach --recursive git checkout master
$ git submodule foreach --recursive git pull

Usage

Within your blueprints

Using the field in your blueprint couldn't be easier. After installing the plugin like explained above, all you need to do is change the type of your text fields to markdown.

fields:
    title:
        label: Post Title
        type:  text
    text:
        label: Text
        type:  markdown

Fields related part of the blueprint for the setup shown in the screenshot.

Within your templates

You don't have to change your templates in order to support this field. Just use content created with this field like any regular textarea field:

<article>
	<h1>
		<?php echo $page->title()->html() ?>
	</h1>
	<?php echo $page->text()->kirbytext() ?>
</article>

Options

toolbar

Show / hide the editor toolbar. Set this to hide if you want the toolbar to disappear. Per default, the toolbar will be shown.

fields:
    text:
        label:   Text
        type:    markdown
		toolbar: hide

tools

With this option you may select which tools you want to show up in the toolbar. Specify a list of all tools you want to show up. Please note that there are two toolbar items that will always shown: the help menu and the fullscreen mode icon.

fields:
    text:
        label:   Text
        type:    markdown
		tools:
			- bold
			- italic
			- orderedList
			- unorderedList

Available tools:

  • header1
  • header2
  • bold
  • italic
  • blockquote
  • unorderedList
  • orderedList
  • link
  • image
  • line

header1 & header2

Specify the header levels to be used with the H1 and H2 toolbar buttons (h1 to h6). Defaults to header1: h1 and header2: h2.

fields:
    text:
        label:   Text
        type:    markdown
		header1: h2
		header2: h3

If you have any suggestions for further configuration options, please let me know.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap