扫二维码与项目经理沟通
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
Wordpress的Markdown支持插件
创新互联长期为超过千家客户提供的网站建设服务,团队从业经验10年,关注不同地域、不同群体,并针对不同对象提供差异化的产品和服务;打造开放共赢平台,与合作伙伴共同营造健康的互联网生态环境。为浑江企业提供专业的成都做网站、网站建设,浑江网站改版等技术服务。拥有10余年丰富建站经验和众多成功案例,为您定制开发。
已经支持markdown,但是我们所使用的WordPrss程序并不原生支持,好在WordPress从来不缺插件。
WordPress的Markdown插件主要有WP-Markdown、Markdown on Save
Improved、Jetpack等。其中最好的当属Jetpack,它也是实现Markdown支持的方式。另有一个JP Markdown插件,插件说明是Jetpack的Markdown模块,笔者没有使用过,读者若有兴趣,可自行尝试。
在WordPress › Jetpack by WordPress.com « WordPress Plugins下载插件,或者在WordPress后台搜索安装即可。安装后请记得在Jetpack后台激活markdown,详情见《
Markdown on Save Improved停止维护,已并入Jetpack
》一文。
需要注意的是,Jetpack支持的是Markdown Extra,和原始Markdown有稍许差别。具体语法,请参见官方文档:《Markdown quick reference》 (wordpress.com上的内容,自备梯子),或者Markdown Extra的语法说明:Michel Fortin – PHP Markdown Extra
三.代码高亮插件
代码高亮插件并非必须,但因为众多使用者需要贴代码,所以在这也介绍下。推荐使用的代码高亮插件是Crayon Syntax Highlighter。
由于插件的自身的原因或者设置不当,使得代码高亮插件和Markdown插件造成冲突,这也是WordPress使用Markdown的最大障碍。而Crayon Syntax Highlighter和Jetpack完全兼容。
贴代码的方式多种多样,可以使用WordPress后台文章编辑处的添加按钮,如图:
或者使用Markdown Extra支持的语法。如:
行内高亮:
`This is code`
效果为:This is code
区块高亮:
~~~~
This is a
piece of code
in a block
~~~~
和
```
This too
```
效果为:
Python
1
2
3
4
This is a
piece of code
in a block
和
Python
1
2
This too
需要注意的是,在 Crayon Syntax Highlighter 设置中不要勾选“捕获 `反引号` 为 标签”,以防和Jetpack插件冲突。
更多在WordPress上使用Markdown的技巧请关注,请关注Markdown - 墙外的梯子
系统做了转换
用wordpress markdown为关键词搜索的话,无论Google还是百度,我的博客墙外的梯子 都是靠前的,如果你搜索了可以看看我的文章。推荐这篇文章使用Markdown写作Wordpress。推荐使用Jetpack或者JP Markdown,后者是Jetpack插件的markdown部分,不推荐使用wp-markdown的原因是会丢失一些特殊内容(至少我之前使用的版本是这样。)
以下为文章内容,知乎这里显示的不好,推荐去看原文使用Markdown写作Wordpress。
-----------
前言
今时今日,Markdown已经越来越流行,作为最流行的博客程序——WordPress,虽然没有原生支持,但是有丰富的插件让WordPress支持Markdown。本文将介绍使用Jetpack插件支持Markdown,Crayon Syntax Highlighter插件来支持代码高亮。
一.什么是Mardkown
Markdown 的目标是实现「易读易写」。
可读性,无论如何,都是最重要的。一份使用 Markdown
格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有
text-to-HTML 格式的影响,包括 Setext、atx、Textile、reStructuredText、Grutatext 和
EtText,而最大灵感来源其实是纯文本电子邮件的格式。
总之, Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像强调。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。
——摘抄自Markdown 语法说明(简体中文版)
简而言之,Mardkown让我们可以抛弃糟糕的富文本编辑器,让我们简单、可控的写作。
Markdown起源于Daring Fireball: Markdown Syntax Documentation,此文也是最原始版本的Markdown的规范。
更多关于Markdown的介绍请参见《使用Markdown写作》或者维基百科Markdown词条。Markdown语法说明请参见Markdown 语法说明(简体中文版) 。
需要注意的是,除了原始的Mardkown,现在已经衍生出Markdown Extra、Github Flavored Markdo、CommonMark等多个版本,他们都是在原始Markdown的基础上进行功能扩充,也基本兼容原始Markdown的语法。
二.Wordpress的Markdown支持插件
已经支持markdown,但是我们所使用的WordPrss程序并不原生支持,好在WordPress从来不缺插件。
WordPress的Markdown插件主要有WP-Markdown、Markdown on Save
Improved、Jetpack等。其中最好的当属Jetpack,它也是实现Markdown支持的方式。另有一个JP Markdown插件,插件说明是Jetpack的Markdown模块,笔者没有使用过,读者若有兴趣,可自行尝试。
在WordPress › Jetpack by WordPress.com « WordPress Plugins下载插件,或者在WordPress后台搜索安装即可。安装后请记得在Jetpack后台激活markdown,详情见《
Markdown on Save Improved停止维护,已并入Jetpack
》一文。
需要注意的是,Jetpack支持的是Markdown Extra,和原始Markdown有稍许差别。具体语法,请参见官方文档:《Markdown quick reference》 (wordpress.com上的内容,自备梯子),或者Markdown Extra的语法说明:Michel Fortin – PHP Markdown Extra
三.代码高亮插件
代码高亮插件并非必须,但因为众多使用者需要贴代码,所以在这也介绍下。推荐使用的代码高亮插件是Crayon Syntax Highlighter。
由于插件的自身的原因或者设置不当,使得代码高亮插件和Markdown插件造成冲突,这也是WordPress使用Markdown的最大障碍。而Crayon Syntax Highlighter和Jetpack完全兼容。
贴代码的方式多种多样,可以使用WordPress后台文章编辑处的添加按钮,如图:
或者使用Markdown Extra支持的语法。如:
行内高亮:
`This is code`
效果为:This is code
区块高亮:
WordPress是PHP+MySQL开源程序,上传程序,如果是本地测试好的网站,需要将数据库同步导入到MySQL中,然后更改配置文件,在根目录下wp-config.php对应的数据库信息。
如果是个全新的程序,需要安装,根据 提示安装非常简单;
这些需要你又一定的站点虚拟主机的基础知识。
如果需要协助请追问.
WordPress 多语言网站插件 – Polylang
插件中心搜索polylang并安装
创建语言
Polylang 有 50 种预定义的语言,在 设置 菜单里,找到 语言,从下拉菜单里选择想要添加的语言的名称,然后点击 添加语言。
如果你想要的语言没在列表里,或者你不想要默认的设置,你可以自己修改,每种语言都有 5 个字段。
全名:在网站上显示的语言的名称,比如:English,Français,简体中文,繁体中文。
区域设置:用在 WordPress 上的语言代码,必须填写跟 WordPress 区域设置一致的代码,不然主题翻译就不能正常工作。一般由两个小写字母,一个下划线,再加上两个大写字母组成。例如:en_US,fr_FR,zh_CN。不过也有一些区域设置只用两个或三个小写字符,比如:ar,el,ckb。
语言代码:这个代码会用在 URL 上,最好使用两个小写字母的 ISO 639-1 语言,比如:en,fr,cn ...
文字方向:一般的语言都是从左向右阅读,不过也会从右向左阅读的语言( 阿拉伯语,希伯来语 )。Polylang 会告诉主题使用 LTR 还是 RTL 样式。注意并不是所有主题都支持两种文字方向( 默认的 2011,2012 主题支持 )。
排序:在语言切换工具上显示的语言的顺序。
记得点击 添加语言 按钮,可劲儿添加,因为没有限制。Polylang 会自动为你下载语言文件。
Polylang 还会试着去下载默认的 2010,2011,2012 这些主题的语言文件,如果也没下成,可以使用上面的地址手工下载,然后放在 /wp-content/themes/your_theme/languages 目录下。
设置
默认语言:当有人第一次访问你网站首页的时候使用的默认的语言。
要是安装 Polylang 在已有的网站上,会出现红色字儿的提示:有些文章,页面,分类或标签还没有设置语言,你想把它们设置为默认的语言吗?你可以点击这个快速设置所有已有的文章,页面,分类,标签的语言。同样适用于自定义内容类型,自定义分类法。注意不会修改文章,页面,分类或者标签的 URL。
检测浏览器语言:勾选以后,如果有人第一次访问你的网站的首页,网站的语言会根据用户的浏览器的设置来设置。如果网站的语言里没有用户浏览器的语言,那么就会使用默认的语言。
URL 修改
重要的选择:
从内容设置语言:Polylang 尽可能不修改 URL,默认,只有需要的时候才添加语言信息到 URL 上(主要是规档),不需要就不会添加( 文章,页面,分类,标签 )。这样即便禁用了这个插件,大部分重要的链接也不会受影响。
语言代码:例如:/en/,当使用简洁链接时会添加到所有 URL 上。这样如果禁用了这个插件,每个 URL 都会遗失语言信息,也就是所有的 URL 链接都会被破坏。
其它控制 URL 的相关选项:
在简洁链接中保留 /language/:月度规档的 URL 就会是这样:
从简洁链接中移除 /language/:月度规档的 URL 会是这样:
为默认语言隐藏 URL 语言信息,这样只有默认的语言会隐藏语言信息,那么默认语言的月度规档的 URL 看起来是这样地:
重定向语言页面到首页:不使用静态首页的话,这个选项是没有用的。例如,首页 URL 看起来是这样:
控制语言与翻译的更多选项:
媒体:翻译媒体的标题与描述。
同步:创建文章与页面的翻译时可以避免重复动作,比如设置分类与标签,特色图像,父页面等等。你可以选择到底用不用同步。如果网站上有自定义内容类型或者分类法的时候,你也可以选择使用语言与翻译。最后别忘了点 保存更改 按钮。
主题的国际化( i18n )与本地化( l10n )
这步很重要,不然你的主题在显示文章或页面的时候不会显示翻译。要跟主题的作者确认一下主题是不是国际化( 是否可翻译 )还有本地化( 已经翻译 )了你需要的语言。了解更多可以参考本站的《 WordPress 主题开发 》课程。
检查主题的 header.php 是否有类似的代码:
html ?php language_attributes(); ?
有些浏览器或机器人会使用这行代码检查你的页面语言。
语言切换器
语言切换小工具( Widgets )
到小工具的管理页面,你可以找到语言切换器,它目前有五个选项:
显示语言名称
显示标示
强制链接到首页
隐藏当前语言
使用下拉菜单的形式显示
如果你取消了 “显示语言名称” 和 “显示标示” 这两个选项,小工具会显示语言名称。如果你勾选了 “使用下拉菜单的形式显示” ,就不会显示标示,无论你是否选择勾选了 “显示标示” 选项。
如果你勾选了“强制链接到首页”,小工具会一直把访问者带到相应的语言的首页上,不勾选,语言切换器会试着找到翻译页。( 没找到的话会回到首页上 )。
如果勾选了 “隐藏当前语言”,小工具就不会显示当前语言。
不管使用哪个选项,切换工具上的语言只有在至少有一个文章或页面使用了这个语言的时候才显示。
语言的标示图像可以在 wp_content/polylang 目录里找到,比如区域设置为 en_US,那么就会使用 en_US.png 这个图像。
导航菜单
你的主题必须支持自定义导航菜单,而且必须在 wp_nav_menu 函数里使用了一个主题区域。例如:
wp_nav_menu(array('theme_location' = 'primary')); 可以
wp_nav_menu(array('menu' = 'nav menu')); 不可以
你可以为每种语言创建菜单。然后到菜单选项卡里的语言设置页面为每种语言选择正确的菜单。
你可以添加一个语言切换器在菜单的结尾处。勾选 “在菜单结尾处显示语言切换器”。
如果你没勾选 “显示语言名称” 还有 “显示标示”,语言切换器会使用语言名称。
如果勾选了“强制链接到首页”,语言切换器会把访问者带到正确的语言的首页,不然它会去寻找翻译页面(没找到的话就会回到首页上)。
勾选 “隐藏当前语言”,语言切换器就不会显示当前语言。
最后记得点击 保存更改 按钮。
字符串翻译
Polylang 可以翻译用户定义的字符串,比如网站的标题,标语,小工具标题。你还可以为每种语言选择不同的语言格式和时间格式。插件或主题可能会添加其它的字符串到这个列表里。
名称:为了方便排序。
字符串:要翻译的字符串。
翻译:不同语言下每个字符串的翻译。
默认所有翻译的字符串都会保存在数据库里,有一个复选框允许你清理在数据库里的没有用的字符串。
翻译分类或标签
设置每个已有的分类与标签的语言非常重要,不然他们不会显示。设置语言,只需要在描述字段下面的下拉菜单里选择。
翻译文章或页面
设置每个已有的文章与页面的语言非常重要,不然他们不会显示。在文章或页面的编辑界面的右边栏上,你可以选择语言。
每种语言你都有三种选项:
不想翻译文章的话可以什么都不做。
如果翻译已经存在的话,在 文章 ID 字段里填上文章的 ID。
如果你想创建一个新的翻译,点击语言后面 添加 链接。如果翻译的分类和标签可用,会自动填到文章翻译里,父页面也是一样的。
同步元数据
Polylang 会同步文章或页面与翻译之间的一些元数据和选项,默认的同步元数据的选项是:
分类与标签
自定义字段
评论与 ping 状态
置顶文章与发布日期
文章格式
页面层级,页面模板,页面排序
特色图像
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流