Skip to content

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
    • Help
    • Support
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
G
General documentation
  • Project
    • Project
    • Details
    • Activity
    • Releases
    • Cycle Analytics
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Charts
  • Issues 23
    • Issues 23
    • List
    • Boards
    • Labels
    • Milestones
  • Merge Requests 2
    • Merge Requests 2
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
    • Charts
  • Packages
    • Packages
    • Container Registry
  • Wiki
    • Wiki
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Charts
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • Documentation
  • General documentation
  • Wiki
  • Documentation Component Model

Documentation Component Model

Last edited by Alexandre Jan 18, 2020
Page history

This is just a help to make your component documentation in order to save time and to be exhautif. Take the freedom you want!

SIB [short name of the functionality]

The description of your functionality should be clear and should be the same as the description of your project

<sib-[name]> is [description].

Try the demo

It's a good practice to set a demo in each functionality.

To launch the demo, please run at the root of the component :

python3 -m http.server 8001

Installation

Explain how to connect your component to the right back end Django module.

In your django project, add the djangoldp_[name] package:

# settings.py
DJANGOLDP_PACKAGES = [
  'djangoldp_[name]',
]

How to use

Show how to implement it.

Once the package is installed, you can use the sib-[name] component:

<html>
<head>
  <!-- import the module in the head of the page -->
  <script type="module" src="link/to/your/component"></script>
</head>

<body>
  <!-- use the component -->
  <sib-[name]
    data-src="[url]"
    attribute1='1'
    attribute2='xyz'>
  </sib-[name]>
</body>
</html>

Notes :

Anything to add about how it works?

Parameters

Name Default Description
data-src undefined URL of ..
extra-context {} Custom extra context
attribute1 10 Explanation about the attribute named 'attribute1'

A personal message

Feel free to share a personal message with your readers. Don't forget to share here your mail address as well!

Hoping it was useful!

Clone repository
  • Build a sib application from scratch
  • Components
    • SiB Ac Checker
    • SiB Delete
    • SiB Display
    • SiB Form
    • SiB Map
    • SiB Widget
    • Sib Calendar
  • Contribution guidelines
  • Documentation Component Model
  • Events
  • Glossary
  • Helpers functions
  • Home
  • How to make components
More Pages

New Wiki Page

Tip: You can specify the full path for the new file. We will automatically create any missing directories.