search

x-cold / yuque-hexo

同步语雀的文章到你的 Hexo 项目吧！
http://blog.lxstart.net/
MIT License
712 stars 82 forks source link

教程描述有待提升 #125

Open Raydon10 opened 1 year ago

Raydon10 commented 1 year ago

感觉教程不好，很多地方难懂

LetTTGACO commented 1 year ago

具体是哪里不清楚呢？文章确实有段时间没更新了，可以把你遇到的问题提出来，最近抽空更新一下

Raydon10 commented 1 year ago

具体是哪里不清楚呢？文章确实有段时间没更新了，可以把你遇到的问题提出来，最近抽空更新一下

主要是教程步骤的连贯衔接和完整性，感觉比较简单的操作却看了挺久。比如

  1. “事先拥有一个hexo项目”，之后没有yuque-hexo安装步骤，紧接着到了yuque-hexo命令行
  2. 后面配置文件的参数列表可以和说明&举例放到一起 当然，这对熟悉hexo的人或者大神没什么问题。

顺便问个小白问题，我按教程配置，从语雀同步文章和生成md文件正常，但报错--[ERROR] 上传图片失败，请检查:......"data":{"error":"bad token","error_code":"BadToken"}......。 我做了这步：

YUQUE_TOKEN=xxx SECRET_ID=xxx SECRET_KEY=xxx yuque-hexo sync

请问这个命令行是写入AK和SK到hexo项目吗，为何我操作后在项目中找不到，被加密了？如何验证我是否成功写入以及排查上述问题？

LetTTGACO commented 1 year ago

具体是哪里不清楚呢？文章确实有段时间没更新了，可以把你遇到的问题提出来，最近抽空更新一下

主要是教程步骤的连贯衔接和完整性，感觉比较简单的操作却看了挺久。比如

  1. “事先拥有一个hexo项目”，之后没有yuque-hexo安装步骤，紧接着到了yuque-hexo命令行
  2. 后面配置文件的参数列表可以和说明&举例放到一起 当然，这对熟悉hexo的人或者大神没什么问题。

顺便问个小白问题，我按教程配置，从语雀同步文章和生成md文件正常，但报错--[ERROR] 上传图片失败，请检查:......"data":{"error":"bad token","error_code":"BadToken"}......。 我做了这步：

YUQUE_TOKEN=xxx SECRET_ID=xxx SECRET_KEY=xxx yuque-hexo sync

请问这个命令行是写入AK和SK到hexo项目吗，为何我操作后在项目中找不到，被加密了？如何验证我是否成功写入以及排查上述问题？

Raydon10 commented 1 year ago

具体是哪里不清楚呢？文章确实有段时间没更新了，可以把你遇到的问题提出来，最近抽空更新一下

主要是教程步骤的连贯衔接和完整性，感觉比较简单的操作却看了挺久。比如

  1. “事先拥有一个hexo项目”，之后没有yuque-hexo安装步骤，紧接着到了yuque-hexo命令行
  2. 后面配置文件的参数列表可以和说明&举例放到一起 当然，这对熟悉hexo的人或者大神没什么问题。

顺便问个小白问题，我按教程配置，从语雀同步文章和生成md文件正常，但报错--[ERROR] 上传图片失败，请检查:......"data":{"error":"bad token","error_code":"BadToken"}......。 我做了这步：

YUQUE_TOKEN=xxx SECRET_ID=xxx SECRET_KEY=xxx yuque-hexo sync

请问这个命令行是写入AK和SK到hexo项目吗，为何我操作后在项目中找不到，被加密了？如何验证我是否成功写入以及排查上述问题？

  • 连贯性问题的话，后续会考虑完善一下，重新更新下
  • badToken 是语雀的token有问题，建议检查下生成时的权限。
  • AK 和SK 是放在环境变量中的，源码中是通过process.env.SECRET_ID来获取的
  • 设置环境变量是在运行时设置的，一般是在packag.json的scripts中配置 image

非常感谢，原来scripts是npm的环境变量。这下理解了。因为我是用了github action，所以在纳闷为什么要区分mac/win命令。Action用mac 的命令没问题，win没测试～

LetTTGACO commented 1 year ago

具体是哪里不清楚呢？文章确实有段时间没更新了，可以把你遇到的问题提出来，最近抽空更新一下

主要是教程步骤的连贯衔接和完整性，感觉比较简单的操作却看了挺久。比如

  1. “事先拥有一个hexo项目”，之后没有yuque-hexo安装步骤，紧接着到了yuque-hexo命令行
  2. 后面配置文件的参数列表可以和说明&举例放到一起 当然，这对熟悉hexo的人或者大神没什么问题。

顺便问个小白问题，我按教程配置，从语雀同步文章和生成md文件正常，但报错--[ERROR] 上传图片失败，请检查:......"data":{"error":"bad token","error_code":"BadToken"}......。 我做了这步：

YUQUE_TOKEN=xxx SECRET_ID=xxx SECRET_KEY=xxx yuque-hexo sync

请问这个命令行是写入AK和SK到hexo项目吗，为何我操作后在项目中找不到，被加密了？如何验证我是否成功写入以及排查上述问题？

  • 连贯性问题的话，后续会考虑完善一下，重新更新下
  • badToken 是语雀的token有问题，建议检查下生成时的权限。
  • AK 和SK 是放在环境变量中的，源码中是通过process.env.SECRET_ID来获取的
  • 设置环境变量是在运行时设置的，一般是在packag.json的scripts中配置 image

非常感谢，原来scripts是npm的环境变量。这下理解了。因为我是用了github action，所以在纳闷为什么要区分mac/win命令。Action用mac 的命令没问题，win没测试～

在script中使用环境变量只是用于本地测试，提交代码的时候千万不要把Token提交了就行