一言

一言介绍:

简单来说,一言(ヒトコト)指的是就是一句话,可以是动漫中的台词,可以是小说中的语句,也可以是网络上的各种小段子。

或是感动,或是开心,又或是单纯的回忆,来到这里,留下你所喜欢的那一句句话,与大家分享,这就是一言存在的目的。

我也是在逛别人博客的时候偶然间发现的一言,你可以用一言来记录一些自己喜欢的句子,再用它提供的API把自己的记录分享出来,感觉很不错呢。

下面就教教大家怎么把一言添加到自己的博客里吧!

添加方法

注意:方法只以我自己的博客添加方法来说明,如果你有更多要求请看官方API的说明:http://hitokoto.us/api.html

首先我们要注意一下几个主要的请求参数(省略对encode参数的说明,有需要的点上面的网址):

cat:返回指定分类的一句话,如果为空则返回任意分类的一言。若请求参数包含uid,则cat对应cid

charset:字符集,支持gbk/utf-8,默认为utf-8

length:返回一句话的长度限制,超出则打断并添加省略号

uid:获取“我的一言”

mix:同时在系统收录的“一言”和获取“我的一言”中随机,若需指定用户分类请使用ucat参数

ucat:配合mix参数使用,用于指定用户分类CID

 

然后我们来说下对一言的具体展示设置,主要是对最后添加的代码里网址的设置,这里需要用到上面的参数。

请求网址:http://api.hitokoto.us/rand

SSL:https://api.hitokoto.us:214/rand

加上一些参数后,就能展示出不同的一言了。比如你可以这样:http://api.hitokoto.us/rand?cat=a&charset=utf-8或者https://api.hitokoto.us:214/rand?cat=a&charset=utf-8(意思是随机展示审核过的投稿里a分类的一言记录,字符编码为UTF-8,网址对应HTTP和HTTPS的网站)

官方投稿分类说明(cat参数具体设置):

a:Anime – 动画

b:Comic – 漫画

c:Game – 游戏

d:Novel – 小说

e:原创

f:来自网络

g:其他

如果你和我一样是准备展示自己收藏的一言,那么你可以这样写:http://api.hitokoto.us/rand?uid=XXXX或者https://api.hitokoto.us:214/rand?uid=XXXX(对应HTTP和HTTPS网站)

这里的UID请点击“我的一言”,在最后的API相关里有写。更具体一点的,你是想展示自己收藏的一言里某个分类的记录,请结合上面的例子将cat=a换成cat=CID(CID为你自己分类目录的CID)。

上面说的,主要是搞定了自定义需要展示的一言的问题,现在再说怎么添加到博客吧!

以下方法来自官方说明,部分修改:

1. 将下面这段代码放入HTML页面的head标签内(放入博客的header.php里)

  1. <script type=“text/javascript” src=“http://api.hitokoto.us/rand?encode=js&charset=utf-8”></script>

上面的网址请根据前面的说明写你自定义的。

2. 将下面这段代码放入页面内需要展示一句话的位置即可

  1. <div id=“hitokoto”><script>hitokoto()</script></div>

该脚本实质为document.write的脚本。

 

当然如果你和我一样只是想放到右侧边栏里,可以直接复制下面的代码,新建一个文本小工具放进去就可以了,效果嘛看我博客的右边栏。

代码:

  1. <script type=“text/javascript” src=“http://api.hitokoto.us/rand?encode=js&charset=utf-8”></script><div id=“hitokoto”><script>hitokoto()</script></div>

注意替换网址哦!

最后再贴一下官方的API说明:http://hitokoto.us/api.html

里面有更加详细的说明以及更多的用法。

说点什么
欢迎评论!不想写邮箱的请填写 [email protected] 哦!
支持Markdown语法
在"[WordPress]为你的WordPress博客添加一言展示"已有5条评论
Loading...