Giter Club home page Giter Club logo

docs.scipy.org's Introduction

docs.scipy.org front page

This repository contains the Sphinx source for the front page of https://docs.scipy.org/

The documentation itself comes from the Numpy and Scipy main repositories.

After cloning this repository, run:

$ git submodule init
$ git submodule update

To get the Sphinx theme used.

To make a local build of the website:

$ make dist

To build and upload the site (requires ssh access to www.scipy.org):

$ make upload USER=myusername

docs.scipy.org's People

Contributors

b-carter avatar dlax avatar ev-br avatar ilayn avatar ivanistheone avatar jarrodmillman avatar larsmans avatar mattip avatar pv avatar rgommers avatar scopatz avatar tupui avatar tylerjereddy avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

docs.scipy.org's Issues

rsync failed to set permissions

After trying to sync gh-30 just now, I get:

$ make upload USER=rgommers
rsync -r -p build/dist/ [email protected]:/srv/docs_scipy_org/doc/
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/.": Operation not permitted (1)
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/_sources": Operation not permitted (1)
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/_static": Operation not permitted (1)
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/_static/css": Operation not permitted (1)
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/_static/img": Operation not permitted (1)
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/_static/js": Operation not permitted (1)
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/_static/less": Operation not permitted (1)
rsync: failed to set permissions on "/srv/docs_scipy_org/doc/_static/less/bootstrap": Operation not permitted (1)
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(1209) [sender=3.1.3]
make: *** [upload] Error 23

The doc upload did work, and the 1.3.2 docs appear to be fine. Perhaps after an update the www-data group permissions can not be changed anymore. By default rsync -r -p only works for files if the user doing the rsync is already the owner or is root. IIRC there was some workaround for that, but I don't remember which one or why it was needed. Maybe the -p should simply be removed.

Bad relatie links on https://docs.scipy.org/doc/scipy/reference/

Hello, I was recently browsing the scipy docs reference/ site: https://docs.scipy.org/doc/scipy/reference/index.html and noticed some link problems with the nav bar:

The same two links work fine work on the main docs page: https://docs.scipy.org/doc/scipy/

so the seems to be the relative links in the header:

One possible fix would be to use absolute paths in the nav header

  • /doc/scipy/reference/getting_started.html
  • /doc/scipy/reference/index.html

Screen Shot 2021-09-17 at 12 47 27 PM

Unfortunately I wasn't able to find the source code for this element to make this change. If someone were to point me in the right direction, I'll be happy to submit a PR to fix this.

No space left on device

Trying to upload the latest docs build: make upload USERNAME=treddy RELEASE=1.6.2 I get cp: /srv/docs_scipy_org/doc/scipy-1.6.2/dist.tar.gz: No space left on device

image

@rgommers Not sure how comfortable I am poking around on that server filesystem--suggestions?

Upload 1.7.2 docs

For now I'm delaying the build/upload of the SciPy 1.7.2 docs because:

  1. The doc theme means that this will guarantee that we break intersphinx/other links, get an avalanche of issues/waste time triaging those, and then eventually patch some of them with manual work by one of two maintainers on the doc server
  2. We're just releasing our first wheels for 3.10, so would be good to focus on any issues related to that before breaking the docs upload again

Remove numpy documentation from google searches

Searching for "numpy standard normal" today in google shows me these top three results

https://docs.scipy.org/doc/numpy-1.15.0/reference/...
No information is available for this page.
Learn why

numpy.random.standard_normal — NumPy v1.20.dev0 Manual
numpy.org › devdocs › reference › random › generated
Draw samples from a standard Normal distribution (mean=0, stdev=1). Note. New code should use the standard_normal method of a default_rng() instance ...

numpy.random.standard_normal — NumPy v1.18 Manual
numpy.org › stable › reference › random › generated
Draw samples from a standard Normal distribution (mean=0, stdev=1). Note. New code should use the standard_normal method of a default_rng() instance ...

The top result is still from this site, even though the robots.txt prevents showing it.

Apparently we could use this google tool https://www.google.com/webmasters/tools/removals to remove the results entirely. Should we?

First Google link for some search queries 404

Hi,
This is not necessarily a bug with the package but just wanted to bring it to your attention. The first google result for some API searches leads to a 404,

image

image

I would be 0% offended if you just close this ticket. My only reason for reporting is to bring visibility. Other than that thanks so much for scipy, pymc3 and ArviZ would not be possible without it.

Cheers!

docs.scipy.org refusing connections

To whom it may concern, it appears the scipy docs server is not accepting connections? We're trying to rebuild our docs and we need the objects.inv file.

Is this the right place to report this?

# curl -vvv https://www.docs.scipy.org
*   Trying 50.17.248.72:443...
* connect to 50.17.248.72 port 443 failed: Connection refused
* Failed to connect to www.docs.scipy.org port 443 after 20 ms: Connection refused
* Closing connection 0
curl: (7) Failed to connect to www.docs.scipy.org port 443 after 20 ms: Connection refused
# date
Mon Oct 31 19:00:58 EDT 2022

Is the website down or did it move?

intersphinx inventory 'https://docs.scipy.org/doc/scipy/reference/objects.inv' not fetchable due to <class 'requests.exceptions.ConnectionError'>: HTTPSConnectionPool(host='docs.scipy.org', port=443): Max retries exceeded with url: /doc/scipy/reference/objects.inv (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at ...>: Failed to establish a new connection: [Errno 111] Connection refused'))

The javascript to generate the "out of date docs" warning for old NumPy docs should only point to numpy.org

Currently the "out of date" docs warning on older NumPy docs shows this

This is documentation for an old release of NumPy (version 1.9.2). Search for this page in the documentation of the latest stable release (version > 1.17).

The first link points to the docs on https://docs.scipy.org, where it should only refer to the newer documentation on https://numpy.org. I think we can remove the first link entirely. The idea was that perhaps the newer documentation has the same structure, so the link can be recreated to the newer docs, but by now the structure has changed so much that will rarely succeed.

xref numpy/numpy#23156

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.