moparisthebest/android.moparisthebest.org
1
0
Fork 0
mirror of https://github.com/moparisthebest/android.moparisthebest.org synced 2025-02-28 16:31:44 -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 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 ``` 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. 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. 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: 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 ``` yml Linklog settings like Daring Fireball
permalink_label: "★" permalink_label: "★"
@ -49,3 +49,25 @@ linklog_marker_position:
linklog_marker_position_feed: linklog_marker_position_feed:
standard_post_marker: "★ " 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;
}
```