Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

:tutor #380

Closed
bovine3dom opened this issue Apr 12, 2018 · 21 comments
Closed

:tutor #380

bovine3dom opened this issue Apr 12, 2018 · 21 comments

Comments

@bovine3dom
Copy link
Member

I've just made it so that the new tab page appears on first install, but this isn't a very good introduction to Tridactyl.

We really ought to make a series of pages for people to navigate so that they can get used to Tridactyl.

Also, somewhat tangential: we should document the command line binds somewhere (up/down, ctrl-c etc).

@glacambre
Copy link
Member

I haven't actually tried it but Oni's tutorial seems pretty good. Maybe we could use it as inspiration? https://github.com/onivim/oni/wiki/Features#interactive-tutorial

@bovine3dom
Copy link
Member Author

First version is now live on the betas and will appear in a new tab on first install.

It is much more wordy than I would like and I am not sure what to do about that.

Also, I think we should cover search engines and settings in more detail.

@rreuvekamp
Copy link

Great tutorial for getting started, especially the Useful normal mode bindings!

@bovine3dom
Copy link
Member Author

Should add a bit about the native messenger.

@glacambre
Copy link
Member

And probably also about H/L for history navigation since a user was asking about it on irc.

@antonva
Copy link
Member

antonva commented Jun 19, 2018

The tutor should have a previous page to compliment the next page href.
Currently, [[ sets off a pretty nasty error on the cmdline.

Error processing followpage(prev) Exception { name: "NS_ERROR_NOT_AVAILABLE", message: "", result: 2147746065, filename: "moz-extension://629263ad-99e5-4e5d-…", lineNumber: 5139, columnNumber: 0, data: null, stack: "urlincrement@moz-extension://629263…" }

@rajeshmanivan
Copy link

Hi, Is it possible to search for a word in a webpage using / and then cycle to the next occurence of the word using n .

@glacambre
Copy link
Member

@rajeshmanivan : Hi, it is possible by using the following commands:

:bind / find
:bind ? find -1
:bind n findnext 1
:bind N findnext -1

But this is not recommended because our find mode is slow and there's no way to know what you've typed so far.

We're planning on implementing a better find mode with #623 but we need to fix other bugs before making it available.

You can subscribe to #64 in order to be notified when find mode becomes available. In the meantime, I'd recommend using the normal / binding to search for words and then using <C-g> in order to jump to the next occurence.

@bovine3dom
Copy link
Member Author

Related: #824.

Also, should probably add a page about containers once the CPU issue is fixed.

@antonva
Copy link
Member

antonva commented Jul 17, 2018

I'll add a tutor page on containers to #754.

@bovine3dom
Copy link
Member Author

bovine3dom commented Aug 18, 2018

The tutor and the rest of the documentation could do with some TLC in time for #903.

Particularly:

  • explain difference between tabs and buffers (i.e, there isn't one)
  • rapid hinting
  • abnormal mode binds

Help wanted. It's just a bunch of text files in src/static/clippy/. No specialist knowledge required, other than knowledge of Tridactyl : )

@x-ji
Copy link

x-ji commented Sep 30, 2018

When I try the keybinding ;k for killing elements on the page about hints, Tridactyl seems to just outright stop to function on that page. Eventually I have to copy and paste the URL to continue viewing the tutorial normally. This behavior can be confusing and is probably a bug.

@bovine3dom
Copy link
Member Author

You're actually the second person to complain about it. We should reword the line that talks about it.

Are you sure it isn't actually just highlighting the mode indicator in the bottom right?

@glacambre
Copy link
Member

glacambre commented Sep 30, 2018

Are you sure it isn't actually just highlighting the mode indicator in the bottom right?

If that's the problem perhaps we could seturl static\/clippy\/hint_mode.html modeindicator false?

edit: Woops, sorry about closing the issue...

@glacambre glacambre reopened this Sep 30, 2018
@bovine3dom
Copy link
Member Author

Yeah, but then ;k would do nothing on the page it is introduced. Maybe we should put a nice fake banner advert at the top?

Or even a real one? $$$

@x-ji
Copy link

x-ji commented Sep 30, 2018

Don't think I saw any change on the page. Pressing Esc or any other key also seemed to have no effect, that's why I copied the URL and reopened the tutorial in a new tab. Not sure though maybe somebody else can double check it.

@bovine3dom
Copy link
Member Author

It works fine for me with the mode indicator enabled or disabled.

@glacambre
Copy link
Member

glacambre commented Oct 21, 2018

laertus on IRC suggests mentioning how to manipulate tabs (moving between then, closing them, restoring tem...).

We should also desbribe the native messenger, what it can do and how to install it.

@danra
Copy link

danra commented Aug 20, 2020

Feedback: the tutorial is great. Thank you.
I'm on a Mac, and it was unclear whether C-x stand for Ctrl-x or Cmd-x. Related, some of the comments such as C-f not working for find unless you unbind it are incorrect on Mac, since Firefox uses Cmd-f and Tridactyl seems to use Ctrl-f.

@bovine3dom
Copy link
Member Author

I think Cmd is referred to by JavaScript and us as "Meta", so <M-x> would mean Cmd-x. We should mention this in the tutorial (along with the exception for find). Thanks :)

@bovine3dom bovine3dom reopened this Aug 20, 2020
@paul-mcnamee
Copy link

@rajeshmanivan : Hi, it is possible by using the following commands:

:bind / find
:bind ? find -1
:bind n findnext 1
:bind N findnext -1

But this is not recommended because our find mode is slow and there's no way to know what you've typed so far.

We're planning on implementing a better find mode with #623 but we need to fix other bugs before making it available.

You can subscribe to #64 in order to be notified when find mode becomes available. In the meantime, I'd recommend using the normal / binding to search for words and then using <C-g> in order to jump to the next occurence.

I think it's worth adding a note for what actual keys <C-g> represents, that notation is likely not known for a beginner.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

8 participants