Боковая панель Apitome исчезает при включении в макет - PullRequest
Новая
       22

Боковая панель Apitome исчезает при включении в макет

0 голосов
/ 30 октября 2018

Я использую гемы rspec_api_documentation и apitome в версии 5.2 ruby ​​on rails app.

Это дает отличную документацию и имеет боковую панель (div # sidebar) для быстрого доступа к нужной части документации. Когда я выбираю 

config.layout = "layouts/application.html.erb"
Параметр

в инициализаторе apitome.rb, документация отображается, но боковая панель исчезла. Глядя на исходный код страницы, код для боковой панели не отображается, то есть это не проблема CSS, HTML-код не помещается в макет. Чтобы убедиться, что в моем файле application.html.erb нет ничего необычного, я упростил это до 

<!DOCTYPE html>
<html>
  <head>
  </head>

  <body>
        <%= yield %>
  </body>
</html>

Эта боковая панель очень полезна, так как мне отобразить ее в макете?

1 Ответ

0 голосов
/ 01 ноября 2018

На основании ответа на эту проблему я смог решить эту проблему.

Я создал новый макет на app/views/layouts.apidocs.html.erb, который отображал apitome/docs/navigation. Простой пример будет следующим: 

# app/views/layouts/apidocs.html.erb

<!DOCTYPE html>
<html>
  <head>
  </head>

  <body>
    <div class="container">
      <div class="row">
        <div class="col-md-4">
          <div id="sidebar" class="sidebar hidden-print" role="complementary">
            <%= render 'apitome/docs/navigation' %>
          </div>
        </div>
        <div class="col-md-8" role="main">
          <div class="docs-section">
            <%= yield %>
          </div>
        </div>
      </div>
    </div>
  </body>
</html>

Затем я настроил этот макет в инициализатор apitome. 

# config/initializers/apitome
Apitome.setup do |config|
   ...
   config.layout = "layouts/apidocs.html.erb"
end

После некоторой работы с CSS, все выглядело хорошо.

...