Creating a page

One can manually create a page by saying:

curl -X POST -H "Authorization: Bearer 8..K" \
> https://kth.instructure.com/api/v1/courses/11/pages \
> -d wiki_page[title]='IK1552AIMS' \
> -d wiki_page[body]='<h2><Aim></h2><\nThis course will give both practical and general knowledge on the protocols that are the basis of the Internet. After this course you should have a good knowledge about Internet protocols and internetworking architecture. You should have a general knowledge aiding you in reading research and standardization documents in the area.'

This will return:

{"title":"IK1552AIMS","created_at":"2016-06-27T14:22:06Z","url":"ik1552aims","editing_roles":"teachers","page_id":94,"last_edited_by":{"id":29,"display_name":"Gerald Q. Maguire Jr. temp","avatar_image_url":"https://secure.gravatar.com/avatar/52e6e0ae2260166c91cd528ba0c72263?s=50\u0026d=http%3A%2F%2Fpeople.kth.se%2F%7Emaguire%2Fmaguire-march-2004-sq.jpg","html_url":"https://kth.instructure.com/courses/11/users/29"},"published":false,"hide_from_students":true,"front_page":false,"html_url":"https://kth.instructure.com/courses/11/pages/ik1552aims","updated_at":"2016-06-27T14:22:06Z","locked_for_user":false,"body":"\u003Ch2\u003EAim\u003C/h2\u003E\\n\u003Cp\u003EThis course will give both practical and general knowledge on the \u003Cem\u003Eprotocols\u003C/em\u003E that are the basis of the Internet. After this course you should have a good knowledge about Internet protocols and internetworking architecture. You should have a general knowledge aiding you in reading research and standardization documents in the area.\u003C/p\u003E"}

… …

One can create a page from an existing save of a KTH Social course page with the following code:

def insert_page_info_module(course_id, course_code, module_name, filename):
    with open(filename, 'r') as file_handle:  # get existing HTML page
        page_contents = file_handle.read()
    file_handle.closed

    tree = html.parse(StringIO(page_contents), html.HTMLParser())

    # The title of the page can be found in the <div class="mainContent">in the <h1 class="title">
    course_title = tree.xpath('//div[@class="mainContent"]//h1[@class="title"]/text()')

    # The actual content of the page can be found in the <div class="mainContent">in the <div class="paragraphs">
    paragraphs= tree.xpath('//div[@class="mainContent"]//div[@class="paragraphs"]')

    # Use the Canvas API to insert the page
    # PUT /api/v1/courses/:course_id/pages
    # wiki_page[title]
    # wiki_page[body]
    # wiki_page[published]
    title=course_code+"-"+course_title[0]
    url = baseUrl + '%s/pages' % (course_id)
    payload={'wiki_page[title]': title,
             'wiki_page[published]': False,
             'wiki_page[body]': str(html.tostring(paragraphs[0], pretty_print=True, method="html"), 'utf-8')}
    r = requests.post(url, headers = header, data=payload)

The initial version of the above code put the page's contents into the URL, but this failed to work when the page's contents were longer than ~2400 bytes. This seems to occur because there is a server limitation on the maximum URL length. The result is that I put the page's contents into the body of the post using JSON encoding.

The sample program insert_page.py Download insert_page.py

 can be used to insert a the title and contents from the KTH Social course page. It is called with
./insert_page.py course_id course_code module filename.html
For example:

 ./insert_page.py  11 IK1552 Internetworking "KTH _ Aim _ Internetworking (IK1552).html"

This outputs:

'Tue Jun 28 10:24:20 2016'
'{"title":"IK1552-Aim","created_at":"2016-06-28T08:24:20Z","url":"ik1552-aim","editing_roles":"teachers","page_id":118,"last_edited_by":{"id":29,"display_name":"Gerald '
'Q. Maguire Jr. '
'temp","avatar_image_url":"https://secure.gravatar.com/avatar/52e6e0ae2260166c91cd528ba0c72263?s=50\\u0026d=http%3A%2F%2Fpeople.kth.se%2F%7Emaguire%2Fmaguire-march-2004-sq.jpg","html_url":"https://kth.instructure.com/courses/11/users/29"},"published":false,"hide_from_students":true,"front_page":false,"html_url":"https://kth.instructure.com/courses/11/pages/ik1552-aim","updated_at":"2016-06-28T08:24:20Z","locked_for_user":false,"body":"\\u003Cdiv '
'class=\\"paragraphs\\"\\u003E\\n\\u003Ch2\\u003EAim\\u003C/h2\\u003E\\n\\u003Cp\\u003EThis '
'course will give both practical and general knowledge on the '
'\\u003Cem\\u003Eprotocols\\u003C/em\\u003E that are the basis of the '
'Internet. After this course you should have a good knowledge about Internet '
...
'a trade paper or national conference in the '
'area.\\u003C/li\\u003E\\n\\u003C/ul\\u003E\\n\\u003C/li\\u003E\\n\\u003C/ul\\u003E\\n\\u003C/div\\u003E"}'
'Tue Jun 28 10:24:22 2016'
'\n--DONE--\n\n'

The resulting page was added as IK1552-Aim, as shown below:

Note that one can upload all of the KTH Social pages in a directory using insert_page1.py Download insert_page1.py

:

for i in *.html; do ./insert_page1.py  11 IK1552 Internetworking "$i"; done

Producing the module "Internetworking" with each of the files inserted as a page:

This has the side effect of adding the relevant pages with IK1552- as a prefix to the Pages, as shown below: