bibtex.feature 6.75 KB
Newer Older
Sylvester Keil's avatar
Sylvester Keil committed
1 2 3 4 5
Feature: BibTeX
  As a scholar who likes to blog
  I want to publish my BibTeX bibliography on my blog
  In order to share my awesome references with my peers

6
  @converters
Sylvester Keil's avatar
Sylvester Keil committed
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
  Scenario: Simple Bibliography
    Given I have a scholar configuration with:
      | key   | value |
      | style | apa   |
     And I have a page "references.bib":
      """
      ---
      ---
      @book{ruby,
        title     = {The Ruby Programming Language},
        author    = {Flanagan, David and Matsumoto, Yukihiro},
        year      = {2008},
        publisher = {O'Reilly Media}
      }
      """
    When I run jekyll
    Then the _site directory should exist
    And the "_site/references.html" file should exist
    And I should see "<i>The Ruby Programming Language</i>" in "_site/references.html"
Sylvester Keil's avatar
Sylvester Keil committed
26

Sylvester Keil's avatar
Sylvester Keil committed
27
  Scenario: Markdown Formatted Bibliography
28
    Given I have a scholar configuration with:
Sylvester Keil's avatar
Sylvester Keil committed
29 30 31 32 33 34 35 36
      | key   | value |
      | style | apa   |
    And I have a page "references.bib":
      """
      ---
      ---
      References
      ==========
37

Sylvester Keil's avatar
Sylvester Keil committed
38 39 40 41 42 43 44 45 46
      @book{ruby,
        title     = {The Ruby Programming Language},
        author    = {Flanagan, David and Matsumoto, Yukihiro},
        year      = {2008},
        publisher = {O'Reilly Media}
      }
      """
    When I run jekyll
    Then I should see "<h1[^>]*>References</h1>" in "_site/references.html"
47 48

  @latex
Sylvester Keil's avatar
Sylvester Keil committed
49
  Scenario: Simple Bibliography with LaTeX directives
50
    Given I have a scholar configuration with:
Sylvester Keil's avatar
Sylvester Keil committed
51 52 53 54 55 56 57 58 59 60 61 62 63 64
      | key   | value |
      | style | apa   |
    And I have a page "references.bib":
      """
      ---
      ---
      @misc{umlaut,
        title     = {Look, an umlaut: \"u!},
      }
      """
    When I run jekyll
    Then the _site directory should exist
    And the "_site/references.html" file should exist
    And I should see "Look, an umlaut: ü!" in "_site/references.html"
65 66

  @tags
Sylvester Keil's avatar
Sylvester Keil committed
67
  Scenario: Simple Bibliography Loaded From Default Directory
68
    Given I have a scholar configuration with:
Sylvester Keil's avatar
Sylvester Keil committed
69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
      | key    | value             |
      | source | ./_bibliography   |
    And I have a "_bibliography" directory
    And I have a file "_bibliography/references.bib":
      """
      @book{ruby,
        title     = {The Ruby Programming Language},
        author    = {Flanagan, David and Matsumoto, Yukihiro},
        year      = {2008},
        publisher = {O'Reilly Media}
      }
      """
    And I have a page "scholar.html":
      """
      ---
      ---
      {% bibliography -f references %}
      """
    When I run jekyll
    Then the _site directory should exist
    And the "_site/scholar.html" file should exist
    And I should see "<i>The Ruby Programming Language</i>" in "_site/scholar.html"
91

Sylvester Keil's avatar
Sylvester Keil committed
92 93 94
  @tags @bibliography @config
  Scenario: Simple Bibliography With Custom Template
    Given I have a scholar configuration with:
95 96 97
      | key                   | value                                         |
      | source                | ./_bibliography                               |
      | bibliography_template | <abbr>{{index}} [{{key}}]</abbr>{{reference}} |
Sylvester Keil's avatar
Sylvester Keil committed
98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
    And I have a "_bibliography" directory
    And I have a file "_bibliography/references.bib":
      """
      @book{ruby,
        title     = {The Ruby Programming Language},
        author    = {Flanagan, David and Matsumoto, Yukihiro},
        year      = {2008},
        publisher = {O'Reilly Media}
      }
      """
    And I have a page "scholar.html":
      """
      ---
      ---
      {% bibliography -f references %}
      """
    When I run jekyll
    Then the _site directory should exist
    And the "_site/scholar.html" file should exist
    And I should see "<i>The Ruby Programming Language</i>" in "_site/scholar.html"
118
    And I should see "<abbr>1 \[ruby\]</abbr><span" in "_site/scholar.html"
Sylvester Keil's avatar
Sylvester Keil committed
119

120
  @tags @filter
Sylvester Keil's avatar
Sylvester Keil committed
121
  Scenario: Filtered Bibliography Loaded From Default Directory
122
    Given I have a scholar configuration with:
Sylvester Keil's avatar
Sylvester Keil committed
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139
      | key    | value             |
      | source | ./_bibliography   |
    And I have a "_bibliography" directory
    And I have a file "_bibliography/references.bib":
      """
      @book{ruby,
        title     = {The Ruby Programming Language},
        author    = {Flanagan, David and Matsumoto, Yukihiro},
        year      = {2008},
        publisher = {O'Reilly Media}
      },
      @book{smalltalk,
        title     = {Smalltalk Best Practice Patterns},
        author    = {Kent Beck},
        year      = {1996},
        publisher = {Prentice Hall}
      }
140

Sylvester Keil's avatar
Sylvester Keil committed
141 142 143 144 145 146 147 148 149 150 151 152
      """
    And I have a page "scholar.html":
      """
      ---
      ---
      {% bibliography -f references --query @book[year <= 2000] %}
      """
    When I run jekyll
    Then the _site directory should exist
    And the "_site/scholar.html" file should exist
    And I should not see "<i>The Ruby Programming Language</i>" in "_site/scholar.html"
    And I should see "<i>Smalltalk Best Practice Patterns</i>" in "_site/scholar.html"
153 154

  @tags @bibliography @prefix
Sylvester Keil's avatar
Sylvester Keil committed
155
  Scenario: A Prefixed Bibliography
156
    Given I have a scholar configuration with:
Sylvester Keil's avatar
Sylvester Keil committed
157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173
      | key    | value             |
      | source | ./_bibliography   |
    And I have a "_bibliography" directory
    And I have a file "_bibliography/references.bib":
      """
      @book{ruby,
        title     = {The Ruby Programming Language},
        author    = {Flanagan, David and Matsumoto, Yukihiro},
        year      = {2008},
        publisher = {O'Reilly Media}
      },
      @book{smalltalk,
        title     = {Smalltalk Best Practice Patterns},
        author    = {Kent Beck},
        year      = {1996},
        publisher = {Prentice Hall}
      }
174

Sylvester Keil's avatar
Sylvester Keil committed
175 176 177 178 179 180 181 182 183 184 185 186
      """
    And I have a page "scholar.html":
      """
      ---
      ---
      {% bibliography --file references --prefix a -q @book[year <= 2000] %}
      """
    When I run jekyll
    Then the _site directory should exist
    And the "_site/scholar.html" file should exist
    And I should not see "ruby" in "_site/scholar.html"
    And I should see "id=\"a-smalltalk\"" in "_site/scholar.html"
Sylvester Keil's avatar
Sylvester Keil committed
187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206

  @tags @bibliography @style
  Scenario: Simple Bibliography Loaded From Default Directory
    Given I have a scholar configuration with:
      | key    | value             |
      | source | ./_bibliography   |
    And I have a "_bibliography" directory
    And I have a file "_bibliography/references.bib":
      """
      @book{ruby,
        title     = {The Ruby Programming Language},
        author    = {Flanagan, David and Matsumoto, Yukihiro},
        year      = {2008},
        publisher = {O'Reilly Media}
      }
      """
    And I have a page "scholar.html":
      """
      ---
      ---
Sylvester Keil's avatar
Sylvester Keil committed
207
      {% bibliography  --style modern-language-association %}
Sylvester Keil's avatar
Sylvester Keil committed
208 209 210 211 212
      """
    When I run jekyll
    Then the _site directory should exist
    And the "_site/scholar.html" file should exist
    And I should see "<i>The Ruby Programming Language</i>. O’Reilly Media, 2008" in "_site/scholar.html"