Nomadic People Migration


    1.0.8 • Public • Published

    Build Status


    hexo-near-post is a tool that proposes article to be read near the one currently consulted. 2 steps in the process, computing of the proximity of all the posts and widget to display the nearest.


    sudo pip install --upgrade -r requirements.txt

    Calculating distance

    The python script (no time to build a node one yet) is comparing all the posts one to one in order to calculate a distance. Distance is based on number of same words in both posts including description, tags, category, title.

    This needs to be run each time a post is created or modified, no link yet with the hexo generate process

    typical usage:

    python --path ~/blog/source/


    • --path: hexo source directory (where _posts will be found)
    • -f: force rebuild of the database
    • --database: link to the near-post.json file (should be at base of your hexo site)

    hexo plugin

    installation from your hexo site directory:

    npm install hexo-near-post --save

    in the _config.yml file, add the following section and configure it as you prefer:

      enabled: true
      limit: 2
      posts: 3
      heading: see also
    • enabled could be turned false if you simply want to disable all the near post section in your articles
    • limit: minimum affinity between post
    • posts: number of post to link with if available
    • heading: name of the section (h2 tag used)

    you can tweek your css for the near_post section:

    #near_posts {
      h2 {
        font-size: 1.4em;
        margin-bottom: 0px;
      ul {
        margin-left: 20px;
     .distance {
         font-size: 0.75rem;
         color: darkgrey;

    finaly on each post you want the near_post section to be added, insert a specific tag:


    you can add it by default in the scaffolds/ file


    npm i hexo-near-post

    DownloadsWeekly Downloads






    Unpacked Size

    8.45 kB

    Total Files


    Last publish


    • achauvin