Explicit paging

[azimonti]

check list

• Add test cases for the changes.
• Passed the CI test.

Description

Adding a flag for explicitPaging introduced in the version 4.0.0 of hexo-pagination. hexojs/hexo-pagination#114
Adding the option to have the last page to be latest which is convenient in case of reverse pagination.

Additional information

[coveralls]

coverage: 94.656% (-5.3%) from 100.0%
when pulling 59ebcaa on azimonti:explicit-paging
into 87a4772 on hexojs:master.

[uiolee]

Missing unit tests. If convenient, please add some test cases

[uiolee]

Personally, I think overwrite_latest should not be added here, as this may confuse users. It makes it ambiguous whether to enable explicit_paging

[uiolee]

In my opinion, this destroys the unambiguity of explicit_paging.
I think adding an additional path will be better than overwriting it.

[azimonti]

this is not modifying if there is a single page. The objective is to have it changed even if there is 1 page. For the users is transparent, it the flag is set then all the pages (even if there is only one) end with /latest in the path

for example /tag/mytag/1 is renamed to /tag/mytag/latest and properly linked if you create a page with all the tags.

the overwrite is made on purpose so that is not duplicating pages (the static generator create the page), as the last page (with number) is never used. You can see the result in my blog.

[uiolee]

maybe moving overwrite_latest verbose to hexo-pagination will be better, I dont sure.

[azimonti]

moving it to hexo-pagination is an option so it can be done once for all the plugin.
But the overwrite is made on purpose.
I have about 90 tags, having 90 duplicated \tag\mytag\1 and \tag\mytag\latest is a waste of generator time and create additional pages that are not used nor needed.

[azimonti]

I moved the logic into hexo-pagination. If the implementation of hexo-pagination is fine and merged, then I can create a test case for this plugin also before the merge. Now I cannot create the fixture because hexo-pagination is not recognizing the new flag.