moparisthebest/android.moparisthebest.org
1
0
Fork 0
mirror of https://github.com/moparisthebest/android.moparisthebest.org synced 2025-02-28 08:21:52 -05:00
Code Issues Releases Wiki Activity

added customization and styling info to linklog docs

Browse Source
This commit is contained in:
Brandon Mathis 2012-02-12 18:12:17 -06:00
parent 6b93a6a57e
commit 4fe0cbeb20
1 changed files with 27 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
source/docs/blogging/linklog/index.markdown
View File

@ -8,9 +8,9 @@ sharing: false
footer: false
---
A linklog is a blogging format where the post titles link directly to an external site and the content of the post offers commentary on the linked piece. This is commonly referred to as a "linked list" because of the [The Daring Fireball Linked List](http://daringfireball.net/linked/) which helped to popularize the format.
A linklog is a blogging format where the post titles link directly to an external site and the content of the post offers commentary on the linked piece. This is commonly referred to as a "linked list" like the [The Daring Fireball Linked List](http://daringfireball.net/linked/) which helped popularize the format.
To publish a linklog with Octopress simply add the url for the item you want to write about to the `external-url` variable in the yaml front matter of a blog post.
To publish linked posts with Octopress simply add the url for the item you want to write about to the `external-url` variable in the yaml front matter of a blog post.
``` yml Sample Yaml Front Matter
---
@ -24,7 +24,7 @@ external-url: http://opinionguy.com/post/uninformed-rant-vs-straw-man/
When you generate your blog, the title link will point to the external url. Also, each post will show it's own permalink, and in the feed there will be a permalink at the end of linklog posts.
## Customization
## Customizing titles
In the `_config.yml` there are some configurations you can change if you like.
@ -37,9 +37,9 @@ linklog_marker_position_feed: after
standard_post_marker:
```
The default settings were inspired by [Marco Arment](http://marco.org) with one exception, in his RSS feed the linklog marker comes before the title to help readers better distinguish which posts are linklogs. To use that style simply change `linklog_marker_position_feed` to `before`.
The default settings were inspired by [Marco Arment](http://marco.org) with one exception, in his RSS feed the linklog marker comes before the title to help readers better distinguish linked posts from normal posts. To use that style simply change `linklog_marker_position_feed` to `before`.
John Gruber takes a different approach than Marco. Rather than mark his linklog posts, he adds the ★ character to the beginning of each of his standard posts. So for example if you wanted to copy [Daring Fireball's](http://daringfireball.net) style, you'd set it up like this.
John Gruber's [Daring Fireball](http://daringfireball.net) takes a different approach than Marco. Rather than mark his linked posts, he adds ★ to the beginning of each of his standard posts. If you wanted to copy that style, you'd set it up like this.
``` yml Linklog settings like Daring Fireball
permalink_label: "★"
@ -49,3 +49,25 @@ linklog_marker_position:
linklog_marker_position_feed:
standard_post_marker: "★ "
```
## Styling
To help distinguish them from standard posts, linked posts have a smaller font size in addition to the linklog marker. When an article is a linked post it is marked with the html5 attribute `data-linklog` to give you a hook to customize styles if you like. If you wanted to set a different color for linked post titles you could add this css to your `sass/custom/styles.scss`.
``` scss Customized linked post title
article[data-linklog] .entry-title a {
color: lime;
}
```
Styles for linklog markers and permalinks can also be customized.
``` scss Customize permalink styles
.entry-title:hover .linklog-marker {
color: $link-color-hover;
}
article a[rel=bookmark] {
font-size: 1.2em;
}
```