fish-shell / fish-site Goto Github PK

The link from https://fishshell.com/blog/release-3-7-0/ points to https://fishshell.com/docs/3.6/relnotes.html instead of the 3.7 version.

After somebody came to the IRC channel asking why her function (using $argv[0]) doesn't work, I think that it should be mentioned in the tutorial, especially considering they do start with 0 in bash, with "unlike other shells" wrapper to make it more noticeable (even if it's just bash, zsh does it just like fish shell).

i found it in Quotes paragraph in the current docs at 03.01.2020
example:
...tring, <a href="#expand-variable">variable expansion</a> still take...

There's a FAQ at http://fishshell.com/docs/2.0/faq.html and http://ridiculousfish.com/shell/faq.html. Most of the content they cover also differs.

I suggest adding the content from the ridiculousfish.com FAQ to the fishshell.com FAQ, and then redirecting (or at least point) the ridiculousfish.com FAQ to the fishshell.com FAQ so you don't have to double your efforts maintaining both.

I can move the content over and send a pull request, I just need to know if I should be editing docs/current or docs/2.0.

Since webconfig now has a new theme (fish-shell/fish-shell#7523), the screenshot on fishshell.com should match it.

I'd add it, but the other screenshots are all mac-themed and I can't create a matching one.

Running dnf install fish works out of the box.

If I search for "for" using the left-side search box on https://fishshell.com/docs/current/index.html, it takes me to https://fishshell.com/docs/current/search.html?q=for&check_keywords=yes&area=default, which says

Your search did not match any documents.

It would be super helpful if all fish commands were searchable.

Commands that seem broken:

• if
• for
• cd
• and
• or

Commands that are <= 3 chars that seem to work:

• end
• set (albeit suboptimal search ranking)

Is it possible Sphinx has the ones that don't work as stopwords?

fish.sh seems way more funk'y than fishshell.com

The example at assets/img/screenshots/scripting.png should be updated to be clearer. See fish-shell/fish-shell#3832 for an example of how that image confused a user.

I was looking at a video tutorial an noticed a config/fish or something, so I remembered about fish and I really liked the autocompletion suggestion feature but, after searching it on google I find the home page of the site which is broken.

In summary, if I do

GET http://fishshell.com/

result is

<Error>
<Code>AccessDenied</Code>
<Message>Access Denied</Message>
<RequestId>2D5A40070D8E3EB0</RequestId>
<HostId>
2/aWeIxZaO/t3xjYs5vJSeYityat3f0lt4z3vaLfivgCW8F0w/g2qAnbeMRXUctN
</HostId>
</Error>

Hi,
I would like to internationalize this site.
Do you have any wishes for using specific framework?
Generally it would be nice to have the possibility to put translations on some online translations site in the future.

The current comic sans look fails to be effective on mobile devices (including android) and could easily be improved by adding some additional fallback font options from modern font stacks

font-family: "Comic Sans MS", "Comic Sans", "Comic Mono", "ComicShannsMono Nerd Font Propo", 'Segoe Print', 'Bradley Hand', Chilanka, TSCu_Comic, casual, cursive;

This will be more effective across multiple devices.

Sincerely,

A handwritten font connoiseur

The current Guix package URL is 404'd.

Perhaps it is possible to replace it with a link to:
https://git.savannah.gnu.org/cgit/guix.git/tree/gnu/packages/shells.scm?id=v0.16.0-126-g95ae013092#n88

Albeit this link points only to a specific version of the package and thus has to be updated periodically.
Alternatively you can perhaps link to https://www.gnu.org/software/guix/packages/F/?

Because the orginal iusse #60 is closed:

Maybe this will help you:
I am using Windows 7 and 7zip.exe for extracting.

Download
  https://github.com/git-for-windows/git/releases/download/v2.16.2.windows.1/Git-2.16.2-64-bit.exe
and install it for example under c:\git

Download
   http://repo.msys2.org/msys/x86_64/fish-2.7.1-2-x86_64.pkg.tar.xz
and extract to a temporary directory for example c:\temp
   xcopy /s c:\temp\etc\*  c:\git\etc\
   xcopy /s c:\temp\usr\*  c:\git\usr\

Download
   http://repo.msys2.org/msys/x86_64/gcc-libs-6.4.0-3-x86_64.pkg.tar.xz
and extract to a temporary directory for example c:\temp
   xcopy /s c:\temp\usr\*  c:\git\usr\

Download
   http://repo.msys2.org/msys/x86_64/bc-1.07.1-1-x86_64.pkg.tar.xz
and extract to a temporary directory for example c:\temp
   xcopy /s c:\temp\usr\*  c:\git\usr\

Usage:

c:\git\bin\bash.exe -c fish
c:\git\bin\bash.exe -c "fish script.fish"

Hi,

I'm a developer front-end working at F.biz and started making some improvements in HTML, CSS and JS.

I'd love to contribute to the project in other ways too, since I use it every day at work and at home. A while ago I made the logo of the oh-my-fish (may know it).

I intend to leave the aesthetics of the site as it is (roots!), however, add compatible with smaller screens, improved HTML, CSS and JS (all assets) with development standards.

I started work on a new branch and may already test -- jumbotron (cool name ✨!) It is already responsive.

What do you think?

The Comic Sans has genuine poetic value, but the magenta backdrop literally hurts my eyes; please consider changing it.

PS Love the other edits!

I suppose it is markup typo with two asterisk symbols here *~/.config/fish/config.fish* in the beginning of the commands.html file.

Add PPA for Ubutnu 14.04

@floam commented on Mon Aug 01 2016

I have never noticed it before but there is a file doc_src/branding/logo.psd checked into master. It's around 3.8MB large. We also have been including it in our releases it seems, where even after being gzipped it's making the tarball about a third larger than it'd otherwise be. It seems to me this would have a better home in a clean branch other than master, or better another repo entirely like fish-site.

The ~4MB PSD doesn't seem to represent the most official logo of fish (despite the filename), instead it seems to be a cool fan-art composition of the ASCII fish with a template for laser-cutters, for having stickers made. What's the thinking here? Nobody downloading fish will need it. Someone searching for fish stickers likely won't find it with it buried there. Shouldn't it go on the website, if anywhere?

@ridiculousfish commented on Mon Aug 01 2016

Oh god, how did that get in there. Yes, let's move it to fish-site.

@floam commented on Mon Aug 01 2016

I'll yank it. How do you want to show it on the actual site of fish-site? I suppose another way to do it is host it in the repo with the README pretty much like this one was and mention on Wiki or something.

@ridiculousfish commented on Mon Aug 01 2016

I think interest in the artwork itself will be low, so it's OK to link to it from an obscure place (like the wiki). But users might like to have a place to buy stickers - that might merit a small link on the site.

@floam commented on Mon Aug 01 2016

OK, "moving" this issue over to fish-site with the magic button in this browser extension... It can be discussed there.

I think it'd be better to change the "tarball" tab in the Go Fish section to a "Sources" tab, and include both the tarball and something telling visitors how to check it out from the git repository.

There are few URLs mistyped in documentation (almost all versions).

1. index.html points to bind.html#special-case-escape , correct commands.html#bind
2. index.html points to fish_mode_prompt.html, correct commands.html#fish_mode_prompt
3. commands.html points to argparse-local-variables, correct #argparse

Hey 👋 I've been using fish since forever, but I keep needing to look up some differences with bash like how to set env variables for a single command. It would be really nice if I could search within the site for that.

I'm working at Algolia and we offer docsearch as a free service for open source projects. It basically crawls the documentation and makes it searchable, and you add an autocomplete to your page so people can search in it.

Let me know if you're interested!

Hi,
In Process expansion part of index.html
https://github.com/fish-shell/fish-site/blob/master/site/docs/current/index.html#L636

It is written with "fg ema will search for ..."
Should this be "fg %ema will search for ..." ?

Just some very tiny typos:

1. Search "a block of commands that can be called as if they where a single command". I think it should be were
2. a operation that changes => an ?
3. documentationfor the => documentation for the

Gentoo install instructions:

emerge fish

You can find logo to use here: http://www.gentoo.org/main/en/name-logo.xml

HTTP and "The Git Protocol" are unauthenticated and should not be used anymore. Please update the following:

• Org URL: https://github.com/fish-shell "http://fishshell.com/" → "https://fishshell.com/"
• Repo description URL: https://github.com/fish-shell/fish-shell "http://fishshell.com/"
• Git clone URL: https://fishshell.com/ "git clone git://github.com/fish-shell/fish-shell.git" → "git clone https://github.com/fish-shell/fish-shell.git"

And consider doing a global replace for those URLs in the git repos to catch all legacy occurrences.

The new color looks very weird to me and the contrast is just too high. I know high contrast mode is a thing but not everyone needs that.

Also in my opinion the comic sans font is just not suitable for a piece of software that interacts with your computer.

Is this some kind of out of the season April fools joke?

fishshell.com should have a favicon.

To reproduce the issue, navigate to a command documentation page that includes a code box example w/ lines that extend beyond the viewport width of a typical phone (code box examples reasonably disable word wrapping, but in doing so lead to a container width that exceeds the viewport of the phone screen). For example:
https://fishshell.com/docs/current/cmds/read.html

The issue seems to originate in pydoctheme.css @ lines:555-57

/* On screens that are less than 700px wide remove anything non-essential
   - the sidebar, the gradient background, ... */
@media screen and (max-width: 700px) { ...

The above media directive targets small (ie. phone) screens, & the offending style setting seems to be the "overflow: clip" style at the bottom of the css block @ lines:590-98

div#fmain {
        border-radius: 0px;
        margin: 0;
        box-shadow: 0;
        width: 100%;
        padding: 0;
        /* We have some padding/margins that would overflow - just remove it */
        overflow: clip;
    }

I'm currently overriding "overflow: clip; " using the uBlock extension's custom filter mechanism.

For anyone looking for a temporary workaround to this clipping issue, you can install uBlock & add the following filter via the extension's dashboard: fishshell.com###fmain:style(overflow: visible !important)

Viewing the site in "desktop mode" also works.

That said, having this issue w/ the above overflow setting resolved by the webmaster would be much appreciated because it makes it impossible to read the online docs on a phone w/ o having to use a workaround!

Thx 🙏 :)

Is "psub shellscript function" -> "sub shellscript function" a typo?

I believe that the main page http://fishshell.com/ should visibly link to http://fishshell.com/release_notes.html, f.ex. next to the tutorial / documentation / FAQ links. We users would appreciate it :-)

Thanks!

Something is going wrong with the layout of monospace text on the fish site, when viewed through Chrome on a Nexus 7 and a Nexus 6P. The same problem occurs on current Chrome Dev.

Content in site/_site folder are static files which are generated by Jekyll, do we need to track these file using git?

Can I update the script for the Python 3?

Would be great to have a RSS feed for the Blog: https://fishshell.com/blog/index.html

"Finally, a command line shell for the 90s"
The 90s? It's 2016.

Hi. Each search request I try, including for query, outputs only the following message:

Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.

I'm on the latest MacOS Safari desktop with JS enabled, if that's of any help checking the issue.
URL: https://fishshell.com/docs/current/search.html?q=for

The "App" link in the "OS X" tab of the "Go Fish" section on the home page points to https://fishshell.com/files/2.3.0/fish.app.zip, which gives me a 404 error when I click on it.

I don't know what URL it is supposed to point to but I don't think it is supposed to do this.

As discussed in fish-shell/fish-shell#6941, following the default instructions for WSL gets you a seriously old version of fish on the default Ubuntu app. Additionally, the WSL instructions now suggest a wide range of distributions, so the WSL instructions should just refer to the Linux tab.

http://fishshell.com/#get_fish_windows (swithc to any download tab) is not working for users in China,
where all google*.com service are not working.

Use http://code.jquery.com instead of googleapis.com
similar to apache/struts-site#46

Hey there!
This is not directly related to the code, but to the web server configuration. The Cloudflare configuration, in this case.

HTTP is not encrypted. While you can't enter any personal details on the website, an attacker could tamper with the website's content, and change the download links to malware. Redirecting automatically to HTTPS is pretty easy and mitigates this issue.

The ideal solution would be to enable HSTS (https://blog.cloudflare.com/enforce-web-policy-with-hypertext-strict-transport-security-hsts/). This can be done with a couple of clicks on the Cloudflare dashboard. Other simpler solution is to create a Page Rule or enable the "Always Use HTTPS" option.

Please consider making these changes and help make the web a safer place!

In Escaping characters section of this site, it's written '\t' escapes the tab character. Is it correct? Shouldn't it be Escape sequence, '\t', represents the tab character? Same problem for many other escape sequences.

http://fishshell.com →

<Error>
<Code>AccessDenied</Code>
<Message>Access Denied</Message>
<RequestId>1372EBE9D841F8B9</RequestId>
<HostId>
9ShoOo4Ni9GXY715IWFoiZbulV4Wo0Q8RfRhmErjroBg3l88hWt6P+YNSA85tWAr4usYCothFzw=
</HostId>
</Error>

A section of text is duplicated in the online documentation for Writing your own completions. The duplicated part starts from "In the complete call above, the" and ends at "If you have disabled them globally".

I checked the source (https://github.com/fish-shell/fish-shell/blob/master/doc_src/completions.rst) but the text isn't duplicated there.

I just thought you might want that one 😉
Unfortunately fish.fish, shell.fish, etc., are not.

-G

It really attracts people.

I've prepared fish completions for salt saltstack/salt#15310 and prepared screencast (gif, using Byzanz). It's a good way to demonstrate features of fish (picture itself says much less).

I think it could look like this: http://dimsemenov.com/plugins/royal-slider with 3-4 short screencast showing autocompletion, multiline editing, fish web configuration.

Download links to Debian, Fedora, OpenSUSE, and Gentoo all target OpenSUSE's website.

I'd like to add a simple CONTRIBUTING.md file to prevent something like #6 from happening again.

I use git for Windows https://git-for-windows.github.io/ that comes with Bash shell.

However from http://fishshell.com/#get_fish_windows it is not clear how to install fish-shell.
pacman is not available, and there is no any Setup options.

$ pacman
bash: pacman: command not found