octopress-multilingual 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 988ada1b8e7e3a6cd445a4c440476df940673fe0
-  data.tar.gz: 3c515dec3ace3c5aa14c8ee44bfd9315821ebf06
+  metadata.gz: c9c4b68e16a7376bd630c41a53223971b9cb8b31
+  data.tar.gz: 914ea8e09eb53c783f427614ef4f596ebe58ac94
 SHA512:
-  metadata.gz: a3e26bcc97084f9ad7c91ef0fe11f449adc7d6ffb224a70db8be66d141eba73e1874fddb753d0178a6832f8630f25beafa8dc2a85bf8082ba22ec1dba0c28dd2
-  data.tar.gz: 67599396585ab3d2b09b088274c07bb29027d23bc475a870d2275ede43ab73c8d0629bb2638ce95c20dfaaff4ad55be1dfbd1ac221282935c0056264cce56a43
+  metadata.gz: e55ab6dd6dcc3c5fd251d47671c432541297ca7bbd6052100a0eeaa56d53195d13e079e6d6400b1ab3a04ec92ad712b003657e7097458cde9c9b94381e97fc67
+  data.tar.gz: 182bcf88b786ab2ca309ce7725c7cab7231bd4908fa74677fa391bfab3d989398e5cf76d0de93bc683cabce4003964c3769a9868c2ff8d06507b2b3a376b8df8

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+### 0.0.2 (2015-01-18)
+
+- New: `{% post_lang %}` block tag.
+
+### 0.0.1 (2015-01-18)
+
+- initial release

data/README.md

@@ -116,23 +116,62 @@ If you don't want language to appear in your URLs, you must configure your own p
 ## Post Indexes and RSS Feeds
 
 This plugin modifies your site's post list. The `site.posts` array **will not contain every post**, but only posts defined with your site's main language or with no language defined.
-You may access secondary languages with `site.posts_by_language`.
 
-For example, to loop through the posts written in your main language (or without a defined language) you would do this:
+Using the `post_lang` liquid block, set the language for posts in your post loop. Here's how to use it:
 
 ```
-{% for post in site.posts.reverse %}
+# Standard post loop (loops through main language)
+{% for post in site.posts %}...{% endfor %}
+
+# Loop through german posts (and crossposts)
+{% post_lang de %}
+{% for post in site.posts %}...{% endfor %}
+{% endpost_lang %}
+```
+
+If your default post index is at `/index.html` you should create additional indexes for each secondary language. If you're also writing in German, create a posts index at `/de/index.html`.
+
+DRY up your templates by putting post loops in an include. 
+
+<!-- title:"From /index.html" -->
+```
+# Render main language post index
+{% include post-index.html %}
+```
+
+<!-- title:"From /de/index.html" -->
+```
+# Render German post index
+{% include post-index.html lang='de' %}
 ```
 
-This is probably the way your posts index and RSS feeds are generated. If you want to loop through the posts from a secondary language — in this case, German — you would want to do this:
+The post loop in your `_includes/post-index.html` file would look
+like this:
 
+<!-- title:"From _includes/post-index.html" -->
 ```
-{% for post in site.posts_by_language.de.reverse %}
+{% post_lang include.lang %}
+{% for post in site.posts %}...{% endfor %}
+{% endpost_lang %}
 ```
 
-If your default post index is at `/index.html` you should create additional indexes for each secondary language. If you're also writing in German, you'd copy your posts index to `/de/index.html`.
+This approach should work for RSS feeds and anything that works with the post loop.
 
-This practice should work for RSS feeds and anything that works with the post loop.
+## Reference posts by language
+
+You may also access secondary languages directly with `site.posts_by_language`.
+
+For example, to loop through the posts written in your main language (or those with no defined language) you would do this:
+
+```
+{% for post in site.posts %}
+```
+
+If you want to loop through the posts from a secondary language — in this case, German — you would want to do this:
+
+```
+{% for post in site.posts_by_language.de %}
+```
 
 ## Contributing
 

data/lib/octopress-multilingual.rb

@@ -1,4 +1,5 @@
 require "octopress-multilingual/version"
+require "octopress-multilingual/posts_by-tag"
 require 'octopress-hooks'
 
 module Octopress

data/lib/octopress-multilingual/posts_by-tag.rb

@@ -0,0 +1,45 @@
+require 'liquid'
+
+module Octopress
+  module Multilingual
+    class PostsByTag < Liquid::Block
+      def initialize(tag_name, markup, tokens)
+        super
+        @lang = markup.strip
+      end
+
+      def render(context)
+        @context    = context
+        @languages  = context['site.languages']
+        lang_posts  = context['site.posts_by_language']
+
+        # Was a language passed in?
+        if lang
+          # Set posts loop, to language
+          context.environments.first['site']['posts'] = lang_posts[lang]
+
+          # Render with new posts context
+          rendered = super(context)
+
+          # Restore posts to context
+          context.environments.first['site']['posts'] = lang_posts[context['site.main_language']]
+
+          rendered
+        else
+          super(context)
+        end
+      end
+
+      def lang
+        # If lang is a local variable, read it from the context
+        lang = [@lang, @context[@lang]].select{|l| @languages.include?(l)}.first
+        if !lang.nil?
+          lang.downcase
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag('post_lang', Octopress::Multilingual::PostsByTag)
+

data/lib/octopress-multilingual/version.rb

@@ -1,5 +1,5 @@
 module Octopress
   module Multilingual
-    VERSION = "0.0.1"
+    VERSION = "0.0.2"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: octopress-multilingual
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Brandon Mathis
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: octopress
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: clash
   requirement: !ruby/object:Gem::Requirement
@@ -101,9 +115,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - lib/octopress-multilingual.rb
+- lib/octopress-multilingual/posts_by-tag.rb
 - lib/octopress-multilingual/version.rb
 homepage: https://github.com/octopress/multilingual
 licenses: