Skip to main content
  • Home
  • Development
  • Documentation
  • Donate
  • Operational login
  • Browse the archive

swh logo
SoftwareHeritage
Software
Heritage
Archive
Features
  • Search

  • Downloads

  • Save code now

  • Add forge now

  • Help

https://hal.archives-ouvertes.fr/halshs-04471220
22 February 2024, 16:04:02 UTC
  • Code
  • Branches (0)
  • Releases (1)
  • Visits
    • Branches
    • Releases
      • HEAD
    • a484edc
    • /
    • pink-my-pad-main
    • /
    • readme.md
    Raw File Download

    To reference or cite the objects present in the Software Heritage archive, permalinks based on SoftWare Hash IDentifiers (SWHIDs) must be used.
    Select below a type of object currently browsed in order to display its associated SWHID and permalink.

    • content
    • directory
    • snapshot
    • release
    origin badgecontent badge
    swh:1:cnt:a494e29b2a9ff71ecedd4e46d3a6a1bdc7627f1d
    origin badgedirectory badge
    swh:1:dir:50295b718c5a4276ff88ec3f458540475c2c28c5
    origin badgesnapshot badge
    swh:1:snp:1cec82382c21679aff8bfdc56a1af78f0ce81b78
    origin badgerelease badge
    swh:1:rel:126858d6c4406c406a2b27070e903c7270fa816a

    This interface enables to generate software citations, provided that the root directory of browsed objects contains a citation.cff or codemeta.json file.
    Select below a type of object currently browsed in order to generate citations for them.

    • content
    • directory
    • snapshot
    • release
    (requires biblatex-software package)
    Generating citation ...
    (requires biblatex-software package)
    Generating citation ...
    (requires biblatex-software package)
    Generating citation ...
    (requires biblatex-software package)
    Generating citation ...
    readme.md
    # Pink My Pad
    
    [Pink my pad](https://pinkmypad.net) is a simple application that turns and serves your online pads into static HTML pages.
    
    What is it for ? It provides a straightforward publishing solution for your pad, making it more stable, customizable at will, and open to discussion.
    
    Pink my pad is made with [Flask](https://flask.palletsprojects.com/) and [Pandoc](https://pandoc.org/), and includes [Hypothes.is](https://web.hypothes.is) for annotation.
    
    ## Usage
    
    Create, update, customize and share your own pages from your pads. 
    
    Visit [pinkmypad.net](https://pinkmypad.net) to start using the application. It is fully free and open. 
    
    
    ## Install locally 
    
    ### Preresquisite
    
    - `python3` 
    - `python3-pip` 
    - `python3-venv` 
    - `pandoc 3.*` (unless you install `pypandoc_binary` which includes Pandoc, as recommended for production)
    
    ### Installation (in a Python virtual env)
    
    ```bash
    # Create a python venv
    python3 -m venv venv
    # activate the env
    source venv/bin/activate
    # install dependencies
    pip install -r requirements.txt
    ```
    
    ## Initiate necessary files and directories
    
    ```bash
    mkdir hedgedoc hackmd lescommuns lamyne framapad
    echo "# Activity log" > activities.log
    ```
    
    ## Launch
    
    ```bash
    python3 -m pmp webapp
    ```
    
    ## Install for production (nginx)
    
    Nothing specific for production. 
    
    I suggest to follow this Digital Ocean's installation tutorial: 
    
    - [serving flask applications with gunicorn and nginx](https://www.digitalocean.com/community/tutorials/how-to-serve-flask-applications-with-gunicorn-and-nginx-on-ubuntu-20-04)
    

    back to top

    Software Heritage — Copyright (C) 2015–2026, The Software Heritage developers. License: GNU AGPLv3+.
    The source code of Software Heritage itself is available on our development forge.
    The source code files archived by Software Heritage are available under their own copyright and licenses.
    Terms of use: Archive access, API— Content policy— Contact— JavaScript license information— Web API