summaryrefslogtreecommitdiff
path: root/docs/gl_objects/wikis.rst
blob: e98b9d44332ffacf43c59f2d08accd49d3c27839 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
##########
Wiki pages
##########


References
==========

* v4 API:

  + :class:`gitlab.v4.objects.ProjectWiki`
  + :class:`gitlab.v4.objects.ProjectWikiManager`
  + :attr:`gitlab.v4.objects.Project.wikis`
  + :class:`gitlab.v4.objects.GroupWiki`
  + :class:`gitlab.v4.objects.GroupWikiManager`
  + :attr:`gitlab.v4.objects.Group.wikis`

* GitLab API for Projects: https://docs.gitlab.com/ce/api/wikis.html
* GitLab API for Groups: https://docs.gitlab.com/ee/api/group_wikis.html

Examples
--------

Get the list of wiki pages for a project. These do not contain the contents of the wiki page. You will need to call get(slug) to retrieve the content by accessing the content attribute::

    pages = project.wikis.list()

Get the list of wiki pages for a group. These do not contain the contents of the wiki page. You will need to call get(slug) to retrieve the content by accessing the content attribute::

    pages = group.wikis.list()

Get a single wiki page for a project::

    page = project.wikis.get(page_slug)

Get a single wiki page for a group::

    page = group.wikis.get(page_slug)

Get the contents of a wiki page::

    print(page.content)

Create a wiki page on a project level::

    page = project.wikis.create({'title': 'Wiki Page 1',
                                 'content': open(a_file).read()})

Update a wiki page::

    page.content = 'My new content'
    page.save()

Delete a wiki page::

    page.delete()