nim-lang / website Goto Github PK

continuation of nim-lang/Nim#5256

The bootstrapping process reports timings and memory usage for this reason and I keep track of these
numbers. So the answer is "yes" but it could be automated more.

Report that compilation speed is being monitored, i guess a gsoc idea for doing a automating this more could be done

here is a reason why it can be important: https://www.reddit.com/r/haskell/comments/45q90s/is_anything_being_done_to_remedy_the_soul/

A sponsors section should be added to the home page.

If I try to open an entry in /feed.xml, my browser (Chrome 64.0.3282.186) tries forwarding me to /blog/2018/03/01/version-0180-released.html.

I actually don't know if this is only a problem with my aggregator, but nevertheless I think that links inside RSS feeds should be absolute. At the moment, this is what I get:

<rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
    <channel>
        <!-- ... -->
        <link>/</link>
        <atom:link href="/feed.xml" rel="self" type="application/rss+xml"/>
        <pubDate>Thu, 01 Mar 2018 22:44:14 +0000</pubDate>
        <lastBuildDate>Thu, 01 Mar 2018 22:44:14 +0000</lastBuildDate>
        <generator>Jekyll v3.4.3</generator>
        <item>
            <title>Version 0.18.0 released</title>
            <description>...</description>
            <pubDate>Thu, 01 Mar 2018 00:00:00 +0000</pubDate>
            <link>/blog/2018/03/01/version-0180-released.html</link>
            <guid isPermaLink="true">/blog/2018/03/01/version-0180-released.html</guid>
        </item>
        <!-- ... -->

site.url seems to be empty, but it works when the site is hosted locally.

Hi, I'm Japanese.
I wanna translate tutorial to Japanese.
So, What should I do first?

since detail page very long even haven't "detailed".

Similar to how the imba site does: http://imba.io/home

As mentioned on IRC, the current Examples section could be moved to the home page, thus freeing some space for a more fully-featured Examples page.

Here's a screenshot: https://www.dropbox.com/s/kwmqmpczm7dsanm/screenshot.178.png?dl=0

FireFox 47.0.2, 120DPI in system settings.

The Nim libraries documentation page, https://nim-lang.org/docs/lib.html#nimble, attempts to load nimblepkglist.js. However, this leads to a 404 HTTP error code (https://nim-lang.org/docs/nimblepkglist.js), and so the page displays an error that "If you are reading this you are missing nimblepkglist.js or have javascript disabled in your browser.", and the JS console displays "Uncaught ReferenceError: gotPackageList is not defined".

I couldn't find a better place to post this, I couldn't find the source for nimblepkglist.js in the Nim repositories I checked.

Heyo.

Firstly - thanks to the maintainers of the site and the language itself.
nim is clearly a labor of love - and I'm excited to learn more about it.

Following the directions in master's README I run...:

$ jekyll server
Configuration file: none
Configuration file: none
     Build Warning: Layout 'page' requested in jekyll/blog.html does not exist.
     Build Warning: Layout 'page' requested in jekyll/community.md does not exist.
     Build Warning: Layout 'page' requested in jekyll/documentation.html does not exist.
     Build Warning: Layout 'default' requested in jekyll/donate.md does not exist.
     Build Warning: Layout 'page' requested in jekyll/examples.html does not exist.
     Build Warning: Layout 'page' requested in jekyll/faq.md does not exist.
     Build Warning: Layout 'default' requested in jekyll/features.html does not exist.
     Build Warning: Layout 'default' requested in jekyll/index.html does not exist.
     Build Warning: Layout 'default' requested in jekyll/install.md does not exist.
     Build Warning: Layout 'page' requested in jekyll/install_unix.md does not exist.
     Build Warning: Layout 'page' requested in jekyll/install_windows.md does not exist.
  Conversion error: Jekyll::Converters::Scss encountered an error while converting 'jekyll/assets/css/main.scss':
                    File to import not found or unreadable: variables. on line 1

This is on ruby 2.3.0 0, jekyll 3.4.3.

I'm not sure where to go from here but a few humble suggestions might be...

1. Committing a .ruby-version and .ruby-gemset file for folks who use rvm or rbenv.
2. Adding a Gemfile to lock down to a specific version of Jekyll.

Hi guys, this is my guest author article submission. Feel free to post it on the nim-lang front page if you think it's worthy enough :)

http://blog.johnnovak.net/2017/04/22/nim-performance-tuning-for-the-uninitiated/

Homebrew/homebrew-core#25070

At the bottom of these pages:
https://nim-lang.org/install_windows.html
https://nim-lang.org/install_unix.html

...there's sort of no indication of where to go from there.
At the bottom, there's just the footer.
Scroll back up to the top and there's just Blog Features Install Documentation Forum Donate.

Ideally, a big friendly call to action button at the bottom of those pages that links to a proper Getting Started page, that would be good.

But even if it just said

What next?

Check out the Tutorials section of the Documentation to get started.

that'd be great

(so I'd suggest doing that simple addition before going thru the effort of designing a new page, and maybe reorganizing things, and potentially getting stuck on whatever)

clicking on Nim Backend Integration on https://nim-lang.org/documentation.html gives the nginx default 404 not found page

Implement a file that specifies sponsor options like URL and logo (the heuristic for retrieving this automatically isn't enough).

Sponsors that need to be fixed:

• Rocket Wristbands -> https://www.rocketwristbands.com/

We all like Nim for different reasons. It would be nice to have the actual users review Nim for the frontpage. This is a common marketing practice and a powerful persuasion technique (when you shop on Amazon you read the reviews, don't you?).

Also, it's a great opportunity for the community members to express their appreciation of the language.

I suggest we collect the testimonials in the comments to this issue.

So that things are a bit prettier, eg if you have a lot of different web browser tabs open on different sites. At the moment the Nim website and forum stand out a bit as having blank icons :-)

The web-site is static and hosted on GH Pages, so I assume no harm would be done if you set "security level" to "Basically Off" (or something like that) and make security code valid for 1 year (don't know how that's called in CF's terms, but there was a switch somewhere in their panel). That would improve browsing experience for us, users of Tor. Thanks.

something like: https://dlang.org/phobos-prerelease/std_algorithm.html (which even has a way to select the tag/branch eg 2.080 instead of master, although at least allowing to serve docs from tip of devel branch, say updated after every PR would be already a big improvement)

EDIT: this is now implemented as of nim-lang/Nim#8992

• [RFC] regarding committing docs and auto-updating documentation website · Issue #25 · citycide/glob
• https://github.com/kaushalmodi/nim-nightly-docs
• Visit https://nim-lang.github.io/Nim/ for the latest docs built from the Nim devel branch.

Given that Nim severely needs to grow its community, the site could do a better job. Improvement suggestions:

• The forum link should be in the main navigation bar.
• Community should be removed from the navigation bar. The link to this page should probably look like "more info" in the community section of the main page.
• FAQ should be removed from the navigation bar to Docs or smth.
• Sponsors should be removed from the navigation bar.
• Install Nim page should have a Windows, Unix and Mac as a separate option. That would be conventional, and consistent with the Support for multiple operating systems section on the Features page.

https://nim-lang.org/docs/lib.html

Click on the link to the document about the standard lib's API design (Xpath is //*[@id="content"]/p[4]/a) and you will get a 404.

I was going to create a PR for this issue, but I'm not sure where the docs are hosted. Happy to help out if I can.

Hi!

I heard that the Nim community had a nediawiki some years back, but that it was ocerrun with spam bots so shut down.

I'd like to revive that idea; eg somewhere wiki-like. Somewhere really informal; unlike the main site. Eg, as a kind of counterpart to IRC and Forum areas, but less susceptible to being overrun with spam bots.

And then a bunch of these tickets could also be closed by making random wiki link entries.

If not Mediawiki, then what else might work?

Could I just do a git pull against the website code, in the community section, and then to add wiki contents; people do a lot of pull requests against there?

If that gets a bit out of hand then maybe all that could be done in a a separate git repo. (?)

So I was watching Johnathan Blow's twitch stream about his new language Jai and stumbled upon a Nim user that stopped using Nim because of a recent breaking change.

The user understandably didn't wish to tell us this as it would have inadvertently ended up in an argument. I wonder if we should make this type of thing easier, perhaps a good way to solve this is an anonymous feedback box on the website?

The Rust FAQ is really good and I'm sure we can answer some of the questions there.

Hi. It would be cool to have installation page for Windows same as Unix (1. installation via choosenim 2. manual installation from zip) :)

We should tell people about the Bountysource campaign, on the home page, and perhaps on other pages (such as the download page).

Add a link to http://planet.nim-lang.org

Related to #41

• https://getmonero.org/
• Patreon

Hi,

I've been sponsoring for months, and I am still a "Past sponsor". It would be nice if the page was updated once in a while, just to know that you actually get the money we send you. Current status reads:

Last updated: 2017-09-07

This isn't really an issue, more a reference of programming language websites that we should take some inspiration from.

• http://racket-lang.org/ - https://news.ycombinator.com/item?id=13242590

A page for Nim downloads should be implemented. Something like Blender's download page?

I not sure to create a pull request so I'm created an issue.
There are a small gaps between polygons, but with my perfectionism and budget monitor they are very notable:

I tried to fix it. Here's what I got:

or maybe make them official! :-)

https://github.com/moigagoo/nimage
http://nimble-explorer.com/
https://glot.io/new/nim

Discussion started at https://irclogs.nim-lang.org/19-05-2018.html#12:45:21

Issue

Regularly on various outlets, a heated debate starts whether Nim is compiled or transpiled to C,C++ and Javascript. This detracts the attention of people from Nim features and benefits to a mere question of semantics.

Hacker News:

• https://news.ycombinator.com/item?id=15161561
• https://news.ycombinator.com/item?id=16497403

Reddit:

• https://www.reddit.com/r/programming/comments/7pi2td/this_is_lily_a_programming_language_that_ive_been/dsie1ff/
• https://www.reddit.com/r/programming/comments/6ak23x/the_future_is_looking_bright_for_python/dhfhyer/
• https://www.reddit.com/r/golang/comments/384i2s/go_channels_goroutines_and_gc_available_in_nim/crsyq8j/
• https://www.reddit.com/r/C_Programming/comments/6wy9xm/what_languages_can_be_compiled_to_o_files_and/dmbrvrg/

Github:

• arnetheduck/nlvm#1 (comment)

Thoughts

Those debates show that the current vocabulary is too limited to describe what Nim does and there is a need to coin another term to end those useless debates.

Solution

I propose the term transmogrifier instead of compiler or transpiler.

transmogrifier

noun

someone or something that can change or transform its appearance to something else

Marketing

Here is a short snipper to introduce the term.

Following heated debates in the Nim community whether Nim was a compiled to C or transpiled to C, and also compiled to JS or transpiled to JS, with arguments one way or the other,
we felt the need to introduce a new terminology as the current ones didn’t address our concerns and failed to communicate what Nim is.
In short Nim transmogrify to C and JS.

I was going to make a pull request but it seems that /docs/tut1.html is not included in this repo.

In reading the tutorial, under the Parameters section, I believe it would be clearer to say

Parameters are immutable in the procedure body.

instead of

Parameters are constant in the procedure body.

(assuming I am interpreting it correctly).

Hi everyone, I noticed that nim's main website is still using the default Nginx error page which show the current version of Nginx and the operative system. I think it would be a better approach to create a custom error page instead of using the default one.

I'm available for help if needed.

Thanks.

Maybe we can use this https://purecss.io/layouts/tucked-menu-vertical/

See https://nim-lang.org/docs/tut1.html#advanced-types-slices

b is initialized as b = "Slices are useless."
however in a few lines later it says: echo b # --> 'Slices are useful.'

it seems to be that the line where b is initialized is wrong. it should be
b is initialized as b = "Slices are useful."

http://devdocs.io/nim/
I don't know who added there Nim, but it's a good site. It's more convenient to use it than the "Searchable index". I suggest adding a link to it on documentation page.

Now that the website is running over HTTPS, it would be worthwhile making use of some of the new HTTP headers such as Strict-Transport-Security and Content-Security-Policy. For a detailed report, see here: https://securityheaders.io/?q=https%3A%2F%2Fnim-lang.org%2F&hide=on&followRedirects=on

The current recommended headers are:

• Strict-Transport-Security
• Content-Security-Policy
• Public-Key-Pins
• X-Frame-Options
• X-XSS-Protection
• X-Content-Type-Options
• Referrer-Policy

The current release number and date is missing from the website.

Additionally, a RSS/Atom feed to receive release notifications could be added:
https://github.com/nim-lang/Nim/releases.atom

The fsmonitor page is returning the 404 error.

https://nim-lang.org/docs/fsmonitor.html

general continuation of nim-lang/Nim#5256

Very nice work on the website. My thoughts

The Homepage

Feel this the point to snag peoples interest, in that regard I would reorder the page layout in this order.

1. The overview (superb)
2. Sponsors/Testimonies/Companies (shows nim is getting some love)
3. Featured Projects (likewise)
4. Small Feature section, 2 columns with small summary of the features. (hook people in, link to features page)
5. News
6. Community

The learn Nim, Github Link , Book (covered in the news) and sponsor blocks should probably be dropped. The info doesn't really serve the goal and links are available on the top for users wanting such info.

Headers should be closer to their paragraphs. When a header hangs evenly between two paragraphs, it's hard to know where it belongs.

Bad:

Better:

The following is a list of awesome features that should be advertised on the front page.

• Sub-milisecond GC pauses (This is being introduced into Golang at the minute, https://twitter.com/brianhatfield/status/804355831080751104, but is something we've had for a while): http://forum.nim-lang.org/t/2646
  • https://medium.com/@octskyward/modern-garbage-collection-911ef4f8bd8e#.og8w1s46v

Some pages still need to be created, such as:

• Community
• Documentation
• Download instructions for each platform
• Sponsors

A < B | strong subset relation (A is a real subset of B)

to

A < B | strong subset relation (A is a proper subset of B)

@Araq @dom96 In Companies using Nim we can clearly see a nice list of happy users - companies.

How about adding them on the front page of nim's official website as a logo responsive slider?

Attempts to view the sha-256 hash return me a 404 from nginx. This is the case for both 32-bit and 64-bit binaries. The binaries themselves are fine. I am attempting this for version 0.17.2.