From f2ff874c2e25a036b95f55e3ab3cbb9b322988f4 Mon Sep 17 00:00:00 2001
From: Gregwar <g.passault@gmail.com>
Date: Tue, 13 May 2014 14:41:59 +0200
Subject: [PATCH] Adding redirection-title:: directive

---
 Directives/RedirectionTitle.php | 32 ++++++++++++++++
 Document.php                    |  9 +++--
 HTML/Nodes/TocNode.php          | 10 ++++-
 Kernel.php                      |  3 +-
 Nodes/RedirectionNode.php       | 65 +++++++++++++++++++++++++++++++++
 Nodes/TitleNode.php             | 11 ++++++
 tests/BuilderTests.php          | 12 ++++++
 tests/builder/input/another.rst |  7 ++++
 8 files changed, 144 insertions(+), 5 deletions(-)
 create mode 100644 Directives/RedirectionTitle.php
 create mode 100644 Nodes/RedirectionNode.php

diff --git a/Directives/RedirectionTitle.php b/Directives/RedirectionTitle.php
new file mode 100644
index 0000000..0b80f37
--- /dev/null
+++ b/Directives/RedirectionTitle.php
@@ -0,0 +1,32 @@
+<?php
+
+namespace Gregwar\RST\Directives;
+
+use Gregwar\RST\Nodes\TitleNode;
+use Gregwar\RST\Span;
+use Gregwar\RST\Parser;
+use Gregwar\RST\Directive;
+
+/**
+ * This sets a new target for a following title, this can be used to change
+ * its link
+ */
+class RedirectionTitle extends Directive
+{
+    public function getName()
+    {
+        return 'redirection-title';
+    }
+
+    public function process(Parser $parser, $node, $variable, $data, array $options)
+    {
+        $document = $parser->getDocument();
+
+        if ($node) {
+            if ($node instanceof TitleNode) {
+                $node->setTarget($data);
+            }
+            $document->addNode($node);
+        }
+    }
+}
diff --git a/Document.php b/Document.php
index d5af968..5f5e5fb 100644
--- a/Document.php
+++ b/Document.php
@@ -93,7 +93,8 @@ public function getTocs()
      * array(
      *     array('Main title', array(
      *         array('Sub title', array()),
-     *         array('Sub title 2', array()
+     *         array('Sub title 2', array(),
+     *         array(array('Redirection', 'target'), array(),
      *     )
      * )
      */
@@ -105,11 +106,13 @@ public function getTitles()
         foreach ($this->nodes as $node) {
             if ($node instanceof TitleNode) {
                 $level = $node->getLevel();
-                $text = $node->getValue() . '';
+                $text = (string)$node->getValue();
+                $redirection = $node->getTarget();
+                $value = $redirection ? array($text, $redirection) : $text;
 
                 if (isset($levels[$level-1])) {
                     $parent = &$levels[$level-1];
-                    $element = array($text, array());
+                    $element = array($value, array());
                     $parent[] = $element;
                     $levels[$level] = &$parent[count($parent)-1][1];
                 }
diff --git a/HTML/Nodes/TocNode.php b/HTML/Nodes/TocNode.php
index 226256c..3686a90 100644
--- a/HTML/Nodes/TocNode.php
+++ b/HTML/Nodes/TocNode.php
@@ -17,7 +17,15 @@ protected function renderLevel($url, $titles, $level = 1, $path = array())
             $path[$level-1] = $k+1;
             list($title, $childs) = $entry;
             $token = 'title.'.implode('.', $path);
-            $html .= '<li><a href="'.$url.'#'.$token.'">'.$title.'</a></li>';
+            $target = $url.'#'.$token;
+
+            if (is_array($title)) {
+                list($title, $target) = $title;
+                $info = $this->environment->resolve('doc', $target);
+                $target = $this->environment->relativeUrl($info['url']);
+            }
+
+            $html .= '<li><a href="'.$target.'">'.$title.'</a></li>';
 
             if ($childs) {
                 $html .= '<ul>';
diff --git a/Kernel.php b/Kernel.php
index fde85e7..5ad0f28 100644
--- a/Kernel.php
+++ b/Kernel.php
@@ -43,7 +43,8 @@ public function getDirectives()
             new Directives\CodeBlock,
             new Directives\Replace,
             new Directives\Toctree,
-            new Directives\Document
+            new Directives\Document,
+            new Directives\RedirectionTitle
         );
     }
 
diff --git a/Nodes/RedirectionNode.php b/Nodes/RedirectionNode.php
new file mode 100644
index 0000000..252d6c4
--- /dev/null
+++ b/Nodes/RedirectionNode.php
@@ -0,0 +1,65 @@
+<?php
+
+namespace Gregwar\RST\Nodes;
+
+abstract class ListNode extends Node
+{
+    protected $lines = array();
+
+    /**
+     * Infos contains:
+     * 
+     * - text: the line text
+     * - depth: the depth in the list level
+     * - prefix: the prefix char (*, - etc.)
+     * - ordered: true of false if the list is ordered
+     */
+    public function addLine(array $line)
+    {
+        $this->lines[] = $line;
+    }
+
+    public function render()
+    {
+        $depth = -1;
+        $value = '';
+        $stack = array();
+
+        foreach ($this->lines as $line) {
+            $prefix = $line['prefix'];
+            $text = $line['text'];
+            $ordered = $line['ordered'];
+            $newDepth = $line['depth'];
+
+            if ($depth < $newDepth) {
+                $tags = $this->createList($ordered);
+                $value .= $tags[0];
+                $stack[] = array($newDepth, $tags[1]."\n");
+                $depth = $newDepth;
+            }
+
+            while ($depth > $newDepth) {
+                $top = $stack[count($stack)-1];
+
+                if ($top[0] > $newDepth) {
+                    $value .= $top[1];
+                    array_pop($stack);
+                    $top = $stack[count($stack)-1];
+                    $depth = $top[0];
+                }
+            }
+
+            $value .= $this->createElement($text, $prefix)."\n";
+        }
+
+        while ($stack) {
+            list($d, $closing) = array_pop($stack);
+            $value .= $closing; 
+        }
+
+        return $value;
+    }
+
+    abstract protected function createElement($text, $prefix);
+    abstract protected function createList($ordered);
+}
diff --git a/Nodes/TitleNode.php b/Nodes/TitleNode.php
index 0b3034b..19b77c9 100644
--- a/Nodes/TitleNode.php
+++ b/Nodes/TitleNode.php
@@ -6,6 +6,7 @@ abstract class TitleNode extends Node
 {
     protected $level;
     protected $token;
+    protected $target = null;
 
     public function __construct($value, $level, $token)
     {
@@ -18,4 +19,14 @@ public function getLevel()
     {
         return $this->level;
     }
+
+    public function setTarget($target)
+    {
+        $this->target = $target;
+    }
+
+    public function getTarget()
+    {
+        return $this->target;
+    }
 }
diff --git a/tests/BuilderTests.php b/tests/BuilderTests.php
index df67068..4dc5f3d 100644
--- a/tests/BuilderTests.php
+++ b/tests/BuilderTests.php
@@ -95,6 +95,18 @@ public function testSubDirective()
         $this->assertContains('<h2>There is a title here</h2>', $contents);
     }
 
+    /**
+     * Test that redirection-title worked
+     */
+    public function testRedirectionTitle()
+    {
+        $contents = file_get_contents($this->targetFile('magic-link.html'));
+        $this->assertNotContains('redirection', $contents);
+
+        $contents = file_get_contents($this->targetFile('index.html'));
+        $this->assertContains('"subdirective.html">See also', $contents);
+    }
+
     public function setUp()
     {
         shell_exec('rm -rf '.$this->targetFile());
diff --git a/tests/builder/input/another.rst b/tests/builder/input/another.rst
index 7035be3..141a66f 100644
--- a/tests/builder/input/another.rst
+++ b/tests/builder/input/another.rst
@@ -5,3 +5,10 @@ Another page
 ============
 
 Hello!
+
+.. redirection-title:: subdirective
+
+See also
+--------
+
+See also: :doc:`subdirective`