activeadmin 2.2.0

data/config/locales/zh-TW.yml

@@ -0,0 +1,135 @@
+"zh-TW":
+  active_admin:
+    dashboard: 儀表板
+    dashboard_welcome:
+      welcome: "歡迎來到 Active Admin，這是預設的儀表板頁面。"
+      call_to_action: "要新增儀表板內容，請查看 'app/admin/dashboard.rb'"
+    view: "檢視"
+    edit: "編輯"
+    delete: "刪除"
+    delete_confirmation: "你確定要刪除嗎？"
+    new_model: "新增 %{model}"
+    edit_model: "編輯 %{model}"
+    delete_model: "刪除 %{model}"
+    details: "%{model} 明細"
+    cancel: "取消"
+    empty: "空的"
+    previous: "前一個"
+    next: "下一個"
+    download: "下載:"
+    has_many_new: "增加新的 %{model}"
+    has_many_delete: "刪除"
+    has_many_remove: "清除"
+    filters:
+      buttons:
+        filter: "篩選"
+        clear: "清除篩選條件"
+      predicates:
+        contains: "包含"
+        equals: "等於"
+        starts_with: "開頭為"
+        ends_with: "結尾為"
+        greater_than: "大於"
+        less_than: "小於"
+    search_status:
+      headline: "搜尋條件:"
+      current_scope: "子集："
+      current_filters: "目前篩選條件："
+      no_current_filters: "無"
+    status_tag:
+      "yes": "是"
+      "no": "否"
+      "unset": "否"
+    main_content: "請實作 %{model}#main_content 以顯示內容。"
+    logout: "登出"
+    powered_by: "Powered by %{active_admin} %{version}"
+    sidebars:
+      filters: "篩選條件"
+      search_status: "搜尋條件"
+    pagination:
+      empty: "找不到 %{model} "
+      one: "顯示 <b>1</b> %{model}"
+      one_page: "顯示 <b>全部 %{n}</b> %{model}"
+      multiple: "總計 <b>%{total}</b> 顯示 %{model} 中<b>%{from}&nbsp;-&nbsp;%{to}</b> 筆"
+      multiple_without_total: "顯示 %{model} 中<b>%{from}&nbsp;-&nbsp;%{to}</b> 筆"
+      entry:
+        one: "筆"
+        other: "筆"
+    any: "任何"
+    blank_slate:
+      content: "尚無 %{resource_name}"
+      link: "建立一筆"
+    dropdown_actions:
+      button_label: "操作"
+    batch_actions:
+      button_label: "批次作業"
+      default_confirmation: "你確定你要這樣做？"
+      delete_confirmation: "你確定要刪除這些 %{plural_model} 嗎？"
+      succesfully_destroyed:
+        one: "成功刪除 1 %{model}"
+        other: "成功刪除 %{count} %{plural_model}"
+      selection_toggle_explanation: "（切換選取）"
+      action_label: "%{title} 已選取"
+      labels:
+        destroy: "刪除"
+    comments:
+      created_at: "建立"
+      resource_type: "資源種類"
+      author_type: "作者身份"
+      body: "內文"
+      author: "作者"
+      add: "新增評論"
+      delete: "刪除評論"
+      delete_confirmation: "你確定要刪除這些評論嗎？"
+      resource: "資源"
+      no_comments_yet: "尚無評論"
+      author_missing: "匿名"
+      title_content: "(%{count}) 則評論"
+      errors:
+        empty_text: "評論儲存失敗，不允許空白的內容。"
+    devise:
+      username:
+        title: "帳號"
+      email:
+        title: "電子郵件信箱"
+      subdomain:
+        title: "子網域"
+      password:
+        title: "密碼"
+      sign_up:
+        title: "註冊"
+        submit: "註冊"
+      login:
+        title: "登入"
+        remember_me: "記住我"
+        submit: "登入"
+      reset_password:
+        title: "忘記密碼？"
+        submit: "重置密碼"
+      change_password:
+        title: "更改你的密碼"
+        submit: "更改我的密碼"
+      unlock:
+        title: "重新發送解鎖指示"
+        submit: "重新發送解鎖指示"
+      resend_confirmation_instructions:
+        title: '重新發送確認信'
+        submit: '重新發送確認信'
+      links:
+        sign_up: "註冊"
+        sign_in: "登入"
+        forgot_your_password: "忘記密碼？"
+        sign_in_with_omniauth_provider: "使用 %{provider} 登入"
+        resend_unlock_instructions: "重新發送解鎖指示"
+        resend_confirmation_instructions: "重新發送確認信"
+    unsupported_browser:
+      headline: "很抱歉，ActiveAdmin 已不再支援 Internet Explorer 8 以下版本的瀏覽器。"
+      recommendation: "建議您升級到最新版本的<a href=\"http://windows.microsoft.com/ie\">Internet Explorer</a>，<a href=\"https://chrome.google.com/\">Google Chrome</a>，或是 <a href=\"https://mozilla.org/firefox/\">Firefox</a>。"
+      turn_off_compatibility_view: "若您是使用 IE 9 或更新的版本，請確認<a href=\"https://support.microsoft.com/zh-tw/help/17471\">「相容性檢視」是關閉的</a>。"
+    access_denied:
+      message: "您沒有權限執行此項操作"
+    index_list:
+      table: "表格"
+      block: "清單"
+      grid: "格狀"
+      blog: "部落格"

data/docs/.gitignore

@@ -0,0 +1 @@
+_site/

data/docs/0-installation.md

@@ -0,0 +1,118 @@
+---
+redirect_from: /docs/0-installation.html
+---
+
+# Installation
+
+Active Admin is a Ruby Gem.
+
+```ruby
+gem 'activeadmin'
+
+# Plus integrations with:
+gem 'devise'
+gem 'cancancan'
+gem 'draper'
+gem 'pundit'
+```
+
+More accurately, it's a [Rails Engine](http://guides.rubyonrails.org/engines.html)
+that can be injected into your existing Ruby on Rails application.
+
+## Setting up Active Admin
+
+After installing the gem, you need to run the generator. Here are your options:
+
+* If you don't want to use Devise, run it with `--skip-users`:
+
+  ```sh
+  rails g active_admin:install --skip-users
+  ```
+
+* If you want to use an existing user class, provide it as an argument:
+
+  ```sh
+  rails g active_admin:install User
+  ```
+
+* Otherwise, with no arguments we will create an `AdminUser` class to use with Devise:
+
+  ```sh
+  rails g active_admin:install
+  ```
+
+The generator adds these core files, among others:
+
+* `app/admin/dashboard.rb`
+* `app/assets/javascripts/active_admin.js`
+* `app/assets/stylesheets/active_admin.scss`
+* `config/initializers/active_admin.rb`
+
+Now, migrate and seed your database before starting the server:
+
+```sh
+rake db:migrate
+rake db:seed
+rails server
+```
+
+Visit `http://localhost:3000/admin` and log in as the default user:
+
+* __User__: admin@example.com
+* __Password__: password
+
+Voila! You're on your brand new Active Admin dashboard.
+
+To register an existing model with Active Admin:
+
+```sh
+rails generate active_admin:resource MyModel
+```
+
+This creates a file at `app/admin/my_model.rb` to set up the UI; refresh your
+browser to see it.
+
+# Upgrading
+
+When upgrading to a new version, it's a good idea to check the [CHANGELOG].
+
+To update the JS & CSS assets:
+
+```sh
+rails generate active_admin:assets
+```
+
+You should also sync these files with their counterparts in the AA source code:
+
+* app/admin/dashboard.rb [~>][dashboard.rb]
+* config/initializers/active_admin.rb [~>][active_admin.rb]
+
+# Gem compatibility
+
+## will_paginate
+
+If you use `will_paginate` in your app, you need to configure an initializer for
+Kaminari to avoid conflicts.
+
+```ruby
+# config/initializers/kaminari.rb
+Kaminari.configure do |config|
+  config.page_method_name = :per_page_kaminari
+end
+```
+
+If you are also using [Draper](https://github.com/drapergem/draper), you may
+want to make sure `per_page_kaminari` is delegated correctly:
+
+```ruby
+Draper::CollectionDecorator.send :delegate, :per_page_kaminari
+```
+
+## simple_form
+
+If you're getting the error `wrong number of arguments (6 for 4..5)`, [read #2703].
+
+[CHANGELOG]: https://github.com/activeadmin/activeadmin/blob/master/CHANGELOG.md
+[dashboard.rb]: https://github.com/activeadmin/activeadmin/blob/master/lib/generators/active_admin/install/templates/dashboard.rb
+[active_admin.rb]: https://github.com/activeadmin/activeadmin/blob/master/lib/generators/active_admin/install/templates/active_admin.rb.erb
+[read #2703]: https://github.com/activeadmin/activeadmin/issues/2703#issuecomment-38140864

data/docs/1-general-configuration.md

@@ -0,0 +1,204 @@
+---
+redirect_from: /docs/1-general-configuration.html
+---
+
+# General Configuration
+
+You can configure Active Admin settings in `config/initializers/active_admin.rb`.
+Here are a few common configurations:
+
+## Authentication
+
+Active Admin requires two settings to authenticate and use the current user
+within your application.
+
++ the method controllers used to force authentication
+
+```ruby
+config.authentication_method = :authenticate_admin_user!
+```
+
++ the method used to access the current user
+
+```ruby
+config.current_user_method = :current_admin_user
+```
+
+Both of these settings can be set to false to turn off authentication.
+
+```ruby
+config.authentication_method = false
+config.current_user_method   = false
+```
+
+## Site Title Options
+
+Every page has what's called the site title on the left side of the menu bar.
+If you want, you can customize it.
+
+```ruby
+config.site_title       = "My Admin Site"
+config.site_title_link  = "/"
+config.site_title_image = "site_image.png"
+config.site_title_image = "http://www.google.com/images/logos/google_logo_41.png"
+config.site_title_image = ->(context) { context.current_user.company.logo_url }
+```
+
+## Internationalization (I18n)
+
+Active Admin comes with translations for a lot of
+[locales](https://github.com/activeadmin/activeadmin/blob/master/config/locales/).
+Active Admin does not provide the translations for the kaminari gem it uses for pagination,
+to get these you can use the
+[kaminari-i18n](https://github.com/tigrish/kaminari-i18n) gem.
+
+To translate Active Admin to a new language or customize an existing
+translation, you can copy
+[config/locales/en.yml](https://github.com/activeadmin/activeadmin/blob/master/config/locales/en.yml)
+to your application's `config/locales` folder and update it. We welcome
+new/updated translations, so feel free to
+[contribute](https://github.com/activeadmin/activeadmin/blob/master/CONTRIBUTING.md)!
+
+When using [devise](https://github.com/plataformatec/devise) for authentication,
+you can use the [devise-i18n](https://github.com/tigrish/devise-i18n)
+gem to get the devise translations for other locales.
+
+## Localize Format For Dates and Times
+
+Active Admin sets `:long` as default localize format for dates and times.
+If you want, you can customize it.
+
+```ruby
+config.localize_format = :short
+```
+
+## Namespaces
+
+When registering resources in Active Admin, they are loaded into a namespace.
+The default namespace is "admin".
+
+```ruby
+# app/admin/posts.rb
+ActiveAdmin.register Post do
+  # ...
+end
+```
+
+The Post resource will be loaded into the "admin" namespace and will be
+available at `/admin/posts`. Each namespace holds on to its own settings that
+inherit from the application's configuration.
+
+For example, if you have two namespaces (`:admin` and `:super_admin`) and want to
+have different site title's for each, you can use the `config.namespace(name)`
+block within the initializer file to configure them individually.
+
+```ruby
+ActiveAdmin.setup do |config|
+  config.site_title = "My Default Site Title"
+
+  config.namespace :admin do |admin|
+    admin.site_title = "Admin Site"
+  end
+
+  config.namespace :super_admin do |super_admin|
+    super_admin.site_title = "Super Admin Site"
+  end
+end
+```
+
+Each setting available in the Active Admin setup block is configurable on a per
+namespace basis.
+
+## Load paths
+
+By default Active Admin files go inside `app/admin/`. You can change this
+directory in the initializer file:
+
+```ruby
+ActiveAdmin.setup do |config|
+  config.load_paths = [File.join(Rails.root, "app", "ui")]
+end
+```
+
+## Comments
+
+By default Active Admin includes comments on resources. Sometimes, this is
+undesired. To disable comments:
+
+```ruby
+# For the entire application:
+ActiveAdmin.setup do |config|
+  config.comments = false
+end
+
+# For a namespace:
+ActiveAdmin.setup do |config|
+  config.namespace :admin do |admin|
+    admin.comments = false
+  end
+end
+
+# For a given resource:
+ActiveAdmin.register Post do
+  config.comments = false
+end
+```
+
+You can change the name under which comments are registered:
+
+```ruby
+config.comments_registration_name = 'AdminComment'
+```
+
+You can change the order for the comments and you can change the column to be
+used for ordering:
+
+```ruby
+config.comments_order = 'created_at ASC'
+```
+
+You can disable the menu item for the comments index page:
+
+```ruby
+config.comments_menu = false
+```
+
+You can customize the comment menu:
+
+```ruby
+config.comments_menu = { parent: 'Admin', priority: 1 }
+```
+
+Remember to indicate where to place the comments and form with:
+
+```ruby
+active_admin_comments
+```
+
+## Utility Navigation
+
+The "utility navigation" shown at the top right normally shows the current user
+and a link to log out. However, the utility navigation is just like any other
+menu in the system; you can provide your own menu to be rendered in its place.
+
+```ruby
+ActiveAdmin.setup do |config|
+  config.namespace :admin do |admin|
+    admin.build_menu :utility_navigation do |menu|
+      menu.add label: "ActiveAdmin.info", url: "http://www.activeadmin.info",
+                                          html_options: { target: :blank }
+      admin.add_current_user_to_menu  menu
+      admin.add_logout_button_to_menu menu
+    end
+  end
+end
+```
+
+## Footer Customization
+
+By default, Active Admin displays a "Powered by ActiveAdmin" message on every
+page. You can override this message and show domain-specific messaging:
+
+```ruby
+config.footer = "MyApp Revision v1.3"
+```