new landing page (first page after opening gateway) with new tabs opening when clicking links

[ulno]

estimate [ulno]: 4h <- if doing more than fixing the links

[mbz4]

Potentially duplicate w/ #89?

[mbz4]

Oh, this refers to when running web_starter and opening localhost:40080 in the browser, the page that displays - when clicking on links there, we would like those links to open a new tab instead of current tab + update/refresh landing page contents.

[mbz4]

This post seems relevant to this issue: https://stackoverflow.com/questions/11716781/open-a-link-in-a-new-window-in-restructuredtext

[mbz4]

Working on this next.
Added explicit header links to important tools.
Next, updating the links to open in new tab (hope it works w/ man pages too).

[mbz4]

So... we don't have direct control over attributes in Sphinx, like target="_blank"...

In order to configure links to open in a new tab in .rst docs we need to adjust Sphinx and use a custom JavaScript solution that automatically adds this attribute to external links when the HTML is loaded in the browser

Resources
---------

Product page: `M5Stack Stick C <https://shop.m5stack.com/products/stick-c?variant=43982750843137>`_

document.addEventListener('DOMContentLoaded', function() {
    var links = document.querySelectorAll('a[href]');
    links.forEach(function(link) {
        if (link.hostname !== window.location.hostname) {
            link.target = '_blank';
        }
    });
});

But this means that all links will open in a new tab.
@ulno would this be desirable behaviour?
I'm new to Sphinx so I'll explore this further...

[mbz4]

Testing this solution:

extensions = [
    "sphinx_new_tab_link",
]

But it wants this:

pip install sphinx-new-tab-link

More here: Guide of sphinx-new-tab-link

Learned about it from here: Stack Overflow: Add open-in-new-tab links in Sphinx/reStructuredText

[mbz4]

This worked out of the box. Navbar links behave the same.
@ulno not sure how to add this pip install to run automagically when installing iotempower...

[mbz4]

It doesn't feel that nice to have new tabs continually open...
and its inconsistent: some navbar links open in new tab some don't

[mbz4]

Having severe caching issues, suspect hidden symlinks to be the culprit:

In other news...
This line makes it possible to include custom .js and .css files and further customise the look and feel of the pages:

#html_static_path = ['_static']

@Natomac

[mbz4]

Resolved previous issue with hard cache clear.

New problem: when viewing on mobile, the little burger button does not work - no drop down or action... this means users have to switch to a desktop site to access navbar items.

[mbz4]

Looking into this too:

[ulno]

Can't we add a post parser to add the target blank and use a convention ton achieve the n parser to detect it? Seems like we could wrap the actual parser. But also not opposed tom potentially switch to nikola or gohugo for website generation. Ulrich

…

On Thu, May 23, 2024, 12:59 mbz ***@***.***> wrote: Looking into this too: image.png (view on web) <https://github.com/iotempire/iotempower/assets/30321314/dc3e5020-0800-4879-8096-ad6f7c9b3c84> — Reply to this email directly, view it on GitHub <#76 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAARV4TDCVHCCCBBLOOJFHDZDW4XVAVCNFSM6AAAAABGQHUFEWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCMRWG4YDQMBVGQ> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[mbz4]

or we can try another site generator - VuePress maybe? (Vue)

or Docusaurus? (react; by Meta)

kinda like both but maybe docusaurus easier to work with?