Docsify: How to position a 'last updated' text before pagination...

[joetidee]

I want to place a Last updated: ${window.$docsify.lastUpdated} text after the article content, but before the pagination block. I cannot do this with either the hook.beforeEach of hook.afterEach plugin method - how can I achieve this?

[anikethsaha]

try keeping the pagination plugin at the last script and use beforeEach and add the markdown for that. pagination plugin is using afterEach hook i think

[joetidee]

If I use beforeEach, I get:

Last updated: undefined

I'm guessing that beforeEach doesn't have access to the window object (?)

[anikethsaha]

try using vm. instead of windows. I don't remember the exact object name and its properties. Need to look there. Check the docsify object inside the vm if present.

[joetidee]

Weirdly, I can see vm.config.lastUpdated in the vm object, but when I console.log it, it is undefined !

[anikethsaha]

vm.config is from the config object of docsify
I can suggest a solution (hacky)
you can set the lastUpdate manually using js in your HTML
or in beforeEach hook you place a placeholder something like __lastUpdate__ and in afterEach you do regex and replace it with the lastUpdate property as it wont be undefined at that time.

Its more like a templating

[joetidee]

ok, I'll try this, but is there going to be an opportunity down the line to be able to append to the article without a hacky approach?

[anikethsaha]

ok, I'll try this, but is there going to be an opportunity down the line to be able to append to the article without a hacky approach?

it depends on how other plugins are written and how they are being used.
if you are using a pagination plugin after your plugin, it shouldn't be an issue then.
its like a waterfall approach

[joetidee]

The hack worked.

[anikethsaha]

any reason to re-open this ?

[joetidee]

ok, it didn't quite work :(. But I'm just trying to figure out what the correct way to format sidebar content is before I post a reply because lastupdated text is appearing correctly on some pages and not on others.

[joetidee]

Do you have any guidelines on formatting sidebar content and also whether markdown files should go into folders, which one should be named index.md, etc.? These all seem to affect how the sidebar interprets the navigation. Is the purpose of the sidebar to only navigate the content of the page itself?

[anikethsaha]

I would recommend you checking the docsify's docs folder and also this https://github.com/posthtml/posthtml.org.

[joetidee]

Problem is that none of these examples have nested folders in their docs with sidebar files in each folder.

[joetidee]

Would be good just to understand what the purpose of the sidebar is - it is to navigate just what's on the page, or to navigate the whole site?

[anikethsaha]

just on the page + other pages present in the docs (by manually adding content in _sidebar.md)

[anikethsaha]

may be for page's content. You need to check it manually like with console.logs/debugger

[joetidee]

In the first example above, the

is being added inside the H3 tag:

Whereas, in the second example above, the

is (correctly) being added to the add of the article (before the pagination block):

[anikethsaha]

I think it might be cause of page content

[joetidee]

Ah, I added a newline to the end of the 'web/index.md' page and it now works. Is it a requirement of markdown files to have a newline at the end?

[anikethsaha]

Is it a requirement of markdown files to have a newline at the end?

I dont know, we are using markedjs to parsing and rendering markdown, so I guess you can ask this question in their repo as well are simply showing what's coming as an output of markedjs.

[joetidee]

Or, you could add a auto-add a newline before appending using the hook.beforeEach method.

[anikethsaha]

Or, you could add a auto-add a newline before appending using the hook.beforeEach method.

yes. with plugin's hook you can. It depends on the different use cases so it is something which should be done by plugins

It looks like you got a workaround working for you. I am closing this issue. Please comment if you need some more clarification 👍