NexT v7 Docs #36

ivan-nginx · 2018-09-13T07:50:11Z

sli1989 · 2018-09-13T09:08:54Z

I think .travis.yml is needed to be re-edited and check on my version. there are some problem maybe.

stevenjoezhang · 2018-11-08T01:31:03Z

What about moving /docs to wiki pages? Many links are broken in these .md files, for example, in https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/CODE_OF_CONDUCT.md, when you click the national flag for another language, it will return a 404 NOT FOUND error.
Create wiki pages will make it easier to maintain.

ivan-nginx · 2018-11-08T04:12:55Z

All main docs will be in website.
About other github docs – this links can be fixed.
Wiki a little bit hard for maintenance.

jiangtj · 2018-11-10T06:02:20Z

~~How about use other static site generators to generate website, such as docsify VuePress etc?~~
wow, NexT has submenu. It's wonderful for docs. Sorry for what I said before.

ivan-nginx · 2018-11-10T10:22:08Z

I think better will be on Hexo & NexT, and it's already done (later will be with multilanguage, like Hexo site). The problem is – too many docs & configurations. We working with Alex on it and site will be ASAP. You also can join to working on site, just write me in Telegram, if you want.

stevenjoezhang · 2019-03-04T15:11:59Z

Recommendation: Publish a new article on theme-next.org each time a new version of NexT is released (Could be done by a bot)

ivan-nginx · 2019-03-04T15:16:10Z

Nice idea. Which bot can do it?

stevenjoezhang · 2019-03-05T12:22:33Z

@ivan-nginx I have wrote one:

const request = require("request"),
    fs = require("fs");

function get() {
    request.get({
        url: "https://api.github.com/repos/theme-next/hexo-theme-next/releases",
        headers: {
            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.1.2 Safari/605.1.15"
        }
    }, function(error, response, body) {
        fs.writeFileSync("data.json", body);
    });
}

function parse() {
    data = JSON.parse(fs.readFileSync("data.json"));
    for (i of data) {
        version = i.html_url.replace("https://github.com/theme-next/hexo-theme-next/releases/tag/v", "");
        time = i.published_at.replace("T", " ").replace("Z", " ");
        body = i.body.replace(/#(\d{1,})/g, "[#$1](https://github.com/theme-next/hexo-theme-next/pull/$1)").replace(/\r\n/g, "\n");
        var str = `---
title: NexT ${version} Released
date: ${time}
---

${body}

[Detailed changes for NexT v${version}](https://github.com/theme-next/hexo-theme-next/releases/tag/v${version})`;
        fs.writeFileSync(`next-${version.split(".").join("-")}-released.md`, str);

    }
}

parse();

Need to run manually

ivan-nginx · 2019-03-05T13:55:27Z

Hmm... 🤔 Need to run from own server or how? Need something like reproduce steps. Mb it can be added under the cron.

stevenjoezhang · 2019-03-06T16:54:40Z

Another suggestion: using bots to keep all these theme-next-* repos up to date.
https://github.com/backstrokeapp/server

ivan-nginx · 2019-03-06T17:33:42Z

Yeah, dude! U look in the right way.

stevenjoezhang · 2019-03-08T04:14:32Z

@ivan-nginx How about adding some warnings to README.md in v5.x to warn the users that the old project is no longer maintained?

ivan-nginx · 2019-03-08T04:17:50Z

@stevenjoezhang Yes, nice idea. You can add it, I'll merge.

ivan-nginx · 2019-03-24T11:44:23Z

@ivan-nginx How about
moving https://github.com/theme-next/hexo-theme-next/blob/master/docs/ALGOLIA-SEARCH.md
and https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/ALGOLIA-SEARCH.md to https://github.com/theme-next/theme-next-algolia-instant-search;

~~Yes!~~ Only links to docs website will be enough.

moving https://github.com/theme-next/hexo-theme-next/blob/master/docs/LEANCLOUD-COUNTER-SECURITY.md
and https://github.com/theme-next/hexo-theme-next/blob/master/docs/zh-CN/LEANCLOUD-COUNTER-SECURITY.md
to https://github.com/theme-next/hexo-leancloud-counter-security
?

~~Yes!~~ Only links to docs website will be enough.

Need to make move like this for all similar docs. For RU docs too.

ivan-nginx · 2019-03-24T16:53:04Z

Besides, do you think there are too many documents about the licence?
https://github.com/theme-next/hexo-theme-next/blob/master/LICENSE.md
https://github.com/theme-next/hexo-theme-next/blob/master/docs/LICENSE.txt
https://github.com/theme-next/hexo-theme-next/blob/master/docs/AGPL3.md

Maybe we can merge them into a single LICENCE file, and then use an ISSUE to maintain a list of contributor (and credits), just like the v7.x ROADMAP

I'm right now working on it, not only on License. Don't touch this docs for now.

About

Yes, theme-next.org can be multi-language. Translated articles are more friendly to users.

Need to move this docs to the site, theme-next.org/docs/..

Actually, some docs already there.

So, my mistake with the question above: #36 (comment) – answer is no. Need just create link from this repos to site with docs with usage for this module.

stevenjoezhang · 2019-03-24T16:56:47Z

For now it seems fine... there are only docs in English on theme-next.org.
We can deal with the multi-language issues in the future. Lots of work need to do.

ivan-nginx · 2019-03-24T17:02:38Z

@stevenjoezhang first of all, u need to join with any supported messengers for NexT, or suggest another one. I suggest to join in Telegram.

ivan-nginx · 2019-03-24T17:17:48Z

@stevenjoezhang please, write me PM in Telegram, I can't to find you there.

ivan-nginx · 2019-03-31T17:04:11Z

@stevenjoezhang so, how we can add to auto-launch this script? Maybe directly in Netlify, this script will be check for new versions and generate if needed?

stevenjoezhang · 2019-07-26T07:05:12Z

so, how we can add to auto-launch this script?

Perhaps we can use another script to get the update, and then send PR to the repository

stevenjoezhang · 2020-03-11T14:38:46Z

Superseded by #88

ivan-nginx assigned iissnan, tsanie, Acris, flashlab, Raincal, Blealtan, uchuhimo, geekrainy, sli1989 and maple3142 Sep 13, 2018

ivan-nginx pinned this issue Dec 13, 2018

ivan-nginx unpinned this issue Dec 13, 2018

ivan-nginx pinned this issue Dec 13, 2018

stevenjoezhang unpinned this issue Mar 14, 2019

stevenjoezhang pinned this issue Mar 14, 2019

stevenjoezhang transferred this issue from theme-next/hexo-theme-next Mar 23, 2019

stevenjoezhang pinned this issue Mar 23, 2019

This comment has been minimized.

Sign in to view

stevenjoezhang unassigned uchuhimo Mar 24, 2019

stevenjoezhang mentioned this issue Aug 4, 2019

Refactor several components in _config.yml theme-next/hexo-theme-next#965

Merged

15 tasks

theme-next deleted a comment from stale bot Oct 29, 2019

stevenjoezhang changed the title ~~NexT Docs~~ NexT v7 Docs Mar 11, 2020

stevenjoezhang closed this as completed Mar 11, 2020

stevenjoezhang unpinned this issue Mar 11, 2020

stevenjoezhang mentioned this issue Aug 21, 2020

NexT v8 Docs next-theme/theme-next-docs#2

Open

16 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

NexT v7 Docs #36

NexT v7 Docs #36

ivan-nginx commented Sep 13, 2018 •

edited by stevenjoezhang

Loading

sli1989 commented Sep 13, 2018

stevenjoezhang commented Nov 8, 2018

ivan-nginx commented Nov 8, 2018

jiangtj commented Nov 10, 2018 •

edited

Loading

ivan-nginx commented Nov 10, 2018

stevenjoezhang commented Mar 4, 2019

ivan-nginx commented Mar 4, 2019

stevenjoezhang commented Mar 5, 2019 •

edited

Loading

ivan-nginx commented Mar 5, 2019

stevenjoezhang commented Mar 6, 2019 •

edited

Loading

ivan-nginx commented Mar 6, 2019

stevenjoezhang commented Mar 8, 2019

ivan-nginx commented Mar 8, 2019

This comment has been minimized.

ivan-nginx commented Mar 24, 2019 •

edited

Loading

ivan-nginx commented Mar 24, 2019 •

edited by stevenjoezhang

Loading

stevenjoezhang commented Mar 24, 2019

ivan-nginx commented Mar 24, 2019

ivan-nginx commented Mar 24, 2019

ivan-nginx commented Mar 31, 2019 •

edited by stevenjoezhang

Loading

stevenjoezhang commented Jul 26, 2019

stevenjoezhang commented Mar 11, 2020

NexT v7 Docs #36

NexT v7 Docs #36

Comments

ivan-nginx commented Sep 13, 2018 • edited by stevenjoezhang Loading

sli1989 commented Sep 13, 2018

stevenjoezhang commented Nov 8, 2018

ivan-nginx commented Nov 8, 2018

jiangtj commented Nov 10, 2018 • edited Loading

ivan-nginx commented Nov 10, 2018

stevenjoezhang commented Mar 4, 2019

ivan-nginx commented Mar 4, 2019

stevenjoezhang commented Mar 5, 2019 • edited Loading

ivan-nginx commented Mar 5, 2019

stevenjoezhang commented Mar 6, 2019 • edited Loading

ivan-nginx commented Mar 6, 2019

stevenjoezhang commented Mar 8, 2019

ivan-nginx commented Mar 8, 2019

This comment has been minimized.

ivan-nginx commented Mar 24, 2019 • edited Loading

ivan-nginx commented Mar 24, 2019 • edited by stevenjoezhang Loading

stevenjoezhang commented Mar 24, 2019

ivan-nginx commented Mar 24, 2019

ivan-nginx commented Mar 24, 2019

ivan-nginx commented Mar 31, 2019 • edited by stevenjoezhang Loading

stevenjoezhang commented Jul 26, 2019

stevenjoezhang commented Mar 11, 2020

ivan-nginx commented Sep 13, 2018 •

edited by stevenjoezhang

Loading

jiangtj commented Nov 10, 2018 •

edited

Loading

stevenjoezhang commented Mar 5, 2019 •

edited

Loading

stevenjoezhang commented Mar 6, 2019 •

edited

Loading

ivan-nginx commented Mar 24, 2019 •

edited

Loading

ivan-nginx commented Mar 24, 2019 •

edited by stevenjoezhang

Loading

ivan-nginx commented Mar 31, 2019 •

edited by stevenjoezhang

Loading