Skip to content

slack qa team 2020 03 06

akabeko edited this page Mar 16, 2020 · 1 revision

2020-03-06

Time (UTC) Icon Name Message
02:59 yamasy1549 その場合、グローバルヘッダーには
特集、使ってみる、サンプル、ドキュメント、FAQ、ブログ、言語設定、GitHubへのリンク
が並ぶことになりますか? ちょっと混雑し過ぎかなぁと思います 🤔
02:59 Kiara Translation 🇬🇧: In that case, the global header
Featured, Try It, Samples, Documentation, FAQ, Blog, Language Settings, Link to GitHub
Will be lined up? I think it's a bit too crowded: thinking_face:
03:28 shinyu Webサイト内の各ページへのリンク(特集、使ってみる、サンプル、ドキュメント、FAQ、ブログ)と、言語設定、GitHubリンクが並んでいるのを、言語設定とGitHubリンクの配置を分けることでうまくいかないでしょうか?
03:28 Kiara Translation 🇬🇧: The link to each page in the website (special feature, try, sample, documentation, FAQ, blog) and the language setting and GitHub link are not lined up. Is not it?
03:39 shinyu FAQはドキュメントの一種であるので、まとめるのがよいかもしれません。階層メニューにはしない方針であるなら、ドキュメントのページにFAQページへのリンクを置くか
(FAQの内容は、ライセンス以外にも追加していくので大きくなると思いますが)
03:39 Kiara Translation 🇬🇧: FAQs are a type of documentation, so it might be nice to summarize them. If your policy is not to use a hierarchical menu, put a link to the FAQ page on the document page
(I think the content of the FAQ will grow as we add more than just licenses)
03:58 ogwata @yamasy1549 @shinyu
言語設定とGitHubリンクを独立させる意見に賛成します。
ただ、FAQとドキュメントを統合させるのはどうでしょう。とくにFAQはライセンス以外の分野の記事を充実させないといけません。

FAQに限らず、今後開発の進捗に連動しつつ、コンテンツを増やしていきたいと思っています。

その意味では、階層メニューにしないと1ページ当たりの長さがとんでもなく長くなり、かえって読みづらくなる懸念があります。

この辺りも明日の開発者会議で検討すべきでしょうね。
03:58 Kiara Translation 🇬🇧:  
I agree with the language setting and GitHub link independence.
But what about integrating the FAQ with the documentation? In particular, the FAQ has to enrich articles in fields other than licensing.

We want to increase the content in the future, not only in FAQs, but also in conjunction with development progress.

In that sense, if you do not use a hierarchical menu, the length per page will be extremely long, and there is a concern that it will be rather difficult to read.

This should be considered at the developer meeting tomorrow.
04:31 shinyu 私も階層メニューが良いと思います。いま作成中のも言語メニューのところはドロップダウンになっているので、ほかのメニュー項目もそのようなドロップダウンになるのでどうでしょうか? スマホ画面などで、“MENU▾” にまとめられるので、そのMENUを開いたときには全メニュー項目がすべて出るのでよいと思います。
04:31 Kiara Translation 🇬🇧: I think the hierarchical menu is also good. The language menu you are currently creating has a drop-down, so what about other menu items? Because it is put together in “MENU▾” on the smartphone screen etc., when the MENU is opened, all the menu items should come out.
07:40 ogwata @yamasy1549
https://vivliostyle-org.yamasy1549.now.sh/ja/getting_started/

「使ってみる」の「Vivliostyle Pub」に以下の画像を入れてください。
https://www.dropbox.com/s/rvk0fou88m2z83e/Editor.png?dl=0

「Vivliostyle CLI」の図版も考えないといけませんね……。
Vivliostyle — open source, web browser based CSS typesetting engine project
07:40 Kiara Translation 🇬🇧:
https://vivliostyle-org.yamasy1549.now.sh/ja/getting_started/

Please put the following image in "Vivliostyle Pub" of "Try it".
https://www.dropbox.com/s/rvk0fou88m2z83e/Editor.png?dl=0

You have to think about the illustration of "Vivliostyle CLI" ...
07:42 ogwata @yamasy1549
他にも足りない部分、足したい部分ががあれば言ってください。できるだけ用意しますので。
07:42 Kiara Translation 🇬🇧:
Please tell us if you have any missing or added parts. I will prepare it as much as possible.
08:06 yamasy1549 @ogwata
ありがとうございます!!
「使ってみる」ページからサンプルを削除して「サンプル」ページを独立させる流れになりそうですね。そうすると「使ってみる」ページの内容が少なくなってしまいそうなので、各ツールの紹介をもっと増やしたいです。

たとえば、Pubなら
• VFM
• エクスポート形式(実装予定のもの)
• 「はじめてVivliostyleに触れる人におすすめしたい」といったお気持ち表明
• 今までのVivliostyleや他のツールではローカルに環境を構築する必要があったが、Pubを使えば、書いてビルドして印刷可能なPDFを作成する流れがブラウザ上で完結できることのアピール
CLIなら
• previewコマンドを実行して出てくる画面のスクショ
• buildコマンドやpreviewコマンドのオプション(出力サイズの指定など。READMEと内容が被ってもいいと思います!)
Viewerなら
• 画面のスクショ
• Web上の文書を読みたいときの指定方法
• ローカル環境にある文書を読みたいときの指定方法
• 便利な機能をいくつか(たとえば、見開き表示と単ページ表示の切り替えなど。たくさんありそう)
• ユーザースタイルの設定方法
などがあると親切だと思います!
08:06 Kiara Translation 🇬🇧:
Thank you! !
It seems that it will be a flow to remove the sample from the “Try It” page and make the “Sample” page independent. The content of the "Try it" page is likely to decrease, so I would like to introduce more tools.

For example, Pub
• VFM
• Export format (to be implemented)
• Expression of feelings such as "I would recommend it to anyone who first touches Vivliostyle"
• In the past, Vivliostyle and other tools had to build the environment locally, but using Pub, the appeal that the flow of writing, building and creating a printable PDF can be completed on the browser
CLI
• A screen screenshot that appears when you execute the preview command
• Options for the build command and preview command (such as specifying the output size. The contents of the README may be covered!)
Viewer
• Screen screen
• How to specify when you want to read a document on the Web
• How to specify when you want to read documents in the local environment
• Some useful features (for example, switching between two-page view and single-page view, likely many)
• How to set user style
I think that it is kind if there is!
08:07 yamasy1549 いっぱいになっちゃいました、すみません 💦
08:07 Kiara Translation 🇬🇧: I'm sorry, it's full: sweat_drops:
08:22 yamasy1549
言語設定、GitHubリンクが並んでいるのを、言語設定とGitHubリンクの配置を分ける
これよくわからなかったんですが、どういうことですか?
08:22 Kiara Translation 🇬🇧: & gt; Language setting and GitHub link are lined up, separate language setting and GitHub link placement
I didn't understand this, what do you mean?
08:39 shinyu その2つのボタンの配置位置を工夫することで、そのほかのメニューが項目が少し多めになっても大丈夫なレイアウトにできないかと考えたのですが、具体的な良いレイアウトのアイデアがあるわけではないです。メニューを階層化するのであれば、必要ないです。
08:39 Kiara Translation 🇬🇧: By arranging the positions of the two buttons, I thought that the other menus could have a good layout even if the items were slightly larger, but I don't have a specific good layout idea. . Not necessary if you want to layer the menu.
09:31 ogwata @yamasy1549 いえいえ、すぐに全ては難しいですが、できるだけ揃えていきます!
09:31 Kiara Translation 🇬🇧:  No, everything is difficult right now, but we'll keep it as close as possible!
09:32 ogwata 他にも思いついたことがあったら、どんどん言ってください!
09:32 Kiara Translation 🇬🇧: If you have any other ideas, please let me know!
09:34 ogwata
言語設定、GitHubリンクが並んでいるのを、言語設定とGitHubリンクの配置を分ける
@shinyu さんの補足ですが、言語とGitHubはグローバルメニューから外し、別の場所に配置するという意味で、私は言いました。
09:34 Kiara Translation 🇬🇧: & gt; Language setting and GitHub link are lined up, separate language setting and GitHub link placement
 As a side note, I said that languages and GitHub should be removed from the global menu and placed elsewhere.
Clone this wiki locally