diff --git a/app/assets/images/embed_list.png b/app/assets/images/embed_list.png new file mode 100644 index 0000000..91b4c53 Binary files /dev/null and b/app/assets/images/embed_list.png differ diff --git a/app/assets/images/embed_question.png b/app/assets/images/embed_question.png new file mode 100644 index 0000000..cfdd543 Binary files /dev/null and b/app/assets/images/embed_question.png differ diff --git a/app/views/help/index.html.erb b/app/views/help/index.html.erb index c4fdc8c..134e820 100644 --- a/app/views/help/index.html.erb +++ b/app/views/help/index.html.erb @@ -11,6 +11,7 @@
  • <%= link_to "Legal FAQ", legal_path %>
  • <%= link_to "Logging In", "#logging_in" %>
  • <%= link_to "Exercise Formatting", "#exercise_formatting" %>
    • +
  • <%= link_to "Lists", "#lists" %>
  • <%= link_to "Roles and Request", "#roles" %>
  • <%= link_to "Authoring", "help/authoring"%>
    • @@ -118,24 +119,33 @@ Fill out the registration form, agree to the site license, and click "Sign up".<

    For more help with LaTeX consult the tutorial.

    -
    Lists
    +
    Lists
    -

    Quadbase supports collaborative efforts by allowing you to create lists where many users can work together. A list is like a shared folder where you can store exercises and allow your collaborators to view and edit them.

    +

    Quadbase supports collaborative efforts by allowing you to create lists where many users can work together. + A list is like a shared folder where you can store exercises and allow your collaborators to view and edit them.

    -

    Creating a new list is simple.

    +

    To create a new list:

      -
    1. Login to Quadbase and click the lists tab.
      2. -
    2. Click "New List", and then provide a name for your list.
      3. -
    3. Click "Create List" button
      4. +
    4. Login to Quadbase and click the lists tab.
      5. +
    5. Click "New List", and then provide a name for your list.
      6. +
    6. Click "Create List" button
    -

    You can now add any person with a Quadbase account to your workgroup.

    +

    To populate a list with questions:

    +
      +
    1. Move a question from one of your existing lists to a new list;
      2. +
    2. Write a new question and save it to your list; or
      3. +
    3. Edit a new version of an existing question and save it to your list.
      4. + +
    + +

    To add any person with a Quadbase account as a member of your list:

    1. Click on the "Lists" tab.
    2. Click on the name of the list you would like to add a user to.
    3. Add a member by searching for the user in the search field at the bottom of the page.
      4. -
    4. Click "Add"
      5. +
    5. Click "Add."
    Roles and Role Requests
    diff --git a/app/views/help/topics/_embed_help.html.erb b/app/views/help/topics/_embed_help.html.erb new file mode 100644 index 0000000..976f811 --- /dev/null +++ b/app/views/help/topics/_embed_help.html.erb @@ -0,0 +1,20 @@ +<%# Copyright 2011-2012 Rice University. Licensed under the Affero General Public + License version 3 or later. See the COPYRIGHT file for details. %> + +
    Embed questions on any web page
    +

    Want to embed a workable Quadbase question on your webpage or blog? Simply copy and paste +the associated embed code to your own site.

    + +
    To embed an individual question:
    + +
      +
    1. Write a new question, or + find an existing question;
      2. +
    2. Open the question and click Embed, located on the lefthand navigatiom menu;
      3. +

      <%=image_tag("embed_question.png", {:border => 1, :width => "75%", + :title => "Embed a question"})%>

      +
    3. Copy and paste the provided HTML code directly to your own site.
      4. +
    +

    When you embed the HTML code, the workable question will also include proper + author attribution. Try it out!

    + diff --git a/app/views/help/topics/_embed_in_LMS.html.erb b/app/views/help/topics/_embed_in_LMS.html.erb new file mode 100644 index 0000000..e2a0ee2 --- /dev/null +++ b/app/views/help/topics/_embed_in_LMS.html.erb @@ -0,0 +1,7 @@ +<%# Copyright 2011-2012 Rice University. Licensed under the Affero General Public + License version 3 or later. See the COPYRIGHT file for details. %> + +
    Embed questions in online learning platform
    +

    Quadbase integrates seamlessly with our online learning platform. Educators can use this + free, easy-to-use platform to deliver study resources, homework and tests to + students. Learn more.

    diff --git a/app/views/help/topics/_practice_widget_help.html.erb b/app/views/help/topics/_practice_widget_help.html.erb new file mode 100644 index 0000000..f99fc6d --- /dev/null +++ b/app/views/help/topics/_practice_widget_help.html.erb @@ -0,0 +1,21 @@ +<%# Copyright 2011-2012 Rice University. Licensed under the Affero General Public + License version 3 or later. See the COPYRIGHT file for details. %> + +
    Embed the Practice Widget on any webpage
    +

    Use our Practice Widget to embed multiple Quadbase questions into any web page. To use +the Practice Widget, you must first populate a list with questions. For more information about +creating lists, go here. + +

    To embed the Quadbase Practice Widget on your website:
    + +
      +
    1. Open the list of questions you want to embed + using the Widget;
      2. +
    2. Click Embed, located on the lefthand navigation menu;
      3. +

      <%=image_tag("embed_list.png", {:border => 1, :width => "75%", + :title => "Embed a question"})%>

      +

    3. Copy and paste the provided HTML code directly to your own site.
      4. + +

      The Practice Widget will include all questions from the list. Try it out!

      + + diff --git a/app/views/home/index.html.erb b/app/views/home/index.html.erb index 440b761..de44202 100644 --- a/app/views/home/index.html.erb +++ b/app/views/home/index.html.erb @@ -36,7 +36,7 @@ Easily use questions in tests and homeworks, or embed in your online learning platform.
      - <%= link_to ">> See examples!", nil, :onclick => "alert('Coming soon!');" %> + <%= link_to ">> See examples!", use_path %>
      diff --git a/app/views/questions/use.html.erb b/app/views/questions/use.html.erb new file mode 100644 index 0000000..76fbcd0 --- /dev/null +++ b/app/views/questions/use.html.erb @@ -0,0 +1,34 @@ +<%# Copyright 2011-2012 Rice University. Licensed under the Affero General Public + License version 3 or later. See the COPYRIGHT file for details. %> + +<%= pageHeading("Use Quadbase questions") %> + +

      All content in the Quadbase repository is licensed under the + Creative Commons Attribution + license (CC-BY). This license makes it easy to use, share, and reuse questions legally, + as long as the original authors are given credit. For general legal questions about + use of Quadbase content, please go here. +

      + +

      Quadbase supports several options for embedding questions in your learning resources. + These features make it easy to give students practice problems, while also automatically + crediting the original authors. Choose from the following options:

      + +<%= link_to "Embed questions in an online learning platform", "#LMS" %>
      +<%= link_to "Embed questions on any web page", "#embed" %>
      +<%= link_to "Embed the Practice Widget on any web page", "#widget" %>
      + +
      + + +
      +<%= render :partial => 'help/topics/embed_in_LMS' %> +
      +
      +<%= render :partial => 'help/topics/embed_help' %> +
      +
      +<%= render :partial => 'help/topics/practice_widget_help' %> +
      +
      + diff --git a/config/routes.rb b/config/routes.rb index 4c44c26..4417ee3 100644 --- a/config/routes.rb +++ b/config/routes.rb @@ -99,6 +99,7 @@ def votable get 'help/messages', :to => 'help#message_help', :as => "messages" get 'help/roles', :to => 'help#roles_help', :as => 'roles' get 'help/topic/:topic_name', :to => 'help#topic', :as => 'topic_help' + get 'questions/use', :to => 'questions#use', :as => 'use' resources :lists do resources :list_members, :only => [:create, :new] do