Merge pull request #2478 from gabrieldemarmiesse/undo_pr_23

Docs: Undo PR #2439 because readthedocs does not behave as expected.

Merge pull request #2478 from gabrieldemarmiesse/undo_pr_23
Docs: Undo PR #2439 because readthedocs does not behave as expected.
54f95d3e · scoder · GitHub · b2b50726 · 1b00a53b · 54f95d3e
Commit 54f95d3e authored Jul 08, 2018 by scoder Committed by GitHub Jul 08, 2018
Hide whitespace changes
Inline Side-by-side

Showing with 176 additions and 39 deletions

docs/conf.py docs/conf.py +0 -39

docs/src/reference/language_basics.rst docs/src/reference/language_basics.rst +176 -0

No files found.
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -455,42 +455,3 @@ pdf_use_numbered_links = False

 # Background images fitting mode
 pdf_fit_background_mode = 'scale'
-
-
-# Making redirection:
-
-html_template = """\
-<html>
-    <head>
-        <script>
-            // Redirect to the new-style URL, but keep any #anchor etc.
-            window.location.href = '{0}';
-        </script>
-        <meta http-equiv="refresh" content="1; url={0}" />
-    </head>
-</html>
-"""
-
-list_redirects = [
-    ('reference/language_basics', 'userguide/language_basics'),
-]
-
-
-def add_legacy_redirects(app, docname):
-    if app.builder.name != 'html':
-        return
-    for old_link, new_link in list_redirects:
-        old_link = "src/" + old_link + ".html"
-        new_link = "src/" + new_link + ".html"
-
-        rel_path = os.path.relpath(new_link, os.path.dirname(old_link))
-
-        html_to_write = html_template.format(rel_path)
-        target_path = app.outdir + '/' + old_link
-
-        with open(target_path, "w+") as f:
-            f.write(html_to_write)
-
-
-def setup(app):
-    app.connect('build-finished', add_legacy_redirects)
--- a/docs/src/reference/language_basics.rst
+++ b/docs/src/reference/language_basics.rst
+.. highlight:: cython
+
+
+***************
+Language Basics
+***************
+
+.. note::
+
+    The sections in this page were moved to the :ref:`language-basics` in the userguide.
+
+=================
+Cython File Types
+=================
+
+This section was moved to :ref:`cython_file_types`.
+
+Implementation File
+===================
+
+What can it contain?
+--------------------
+
+What can't it contain?
+----------------------
+
+Definition File
+===============
+
+What can it contain?
+--------------------
+
+What can't it contain?
+----------------------
+
+What else?
+----------
+
+cimport
+```````
+
+compilation order
+`````````````````
+
+Include File
+============
+
+What can it contain?
+--------------------
+
+How do I use it?
+----------------
+
+====================
+Declaring Data Types
+====================
+
+This section was moved to :ref:`declaring_data_types`.
+
+The cdef Statement
+==================
+
+This section was moved to :ref:`c_variable_and_type_definitions`.
+
+Grouping cdef Declarations
+==========================
+
+This section was moved to :ref:`c_variable_and_type_definitions`.
+
+C types and Python classes
+==========================
+
+This section was moved to :ref:`types`.
+
+Parameters
+==========
+
+This section was moved to :ref:`python_functions_vs_c_functions`.
+
+Automatic Type Conversion
+=========================
+
+This section was moved to :ref:`type-conversion`.
+
+Type Casting
+============
+
+This section was moved to :ref:`type_casting`.
+
+Checked Type Casts
+------------------
+
+This section was moved to :ref:`checked_type_casts`.
+
+==========================
+Statements and Expressions
+==========================
+
+This section was moved to :ref:`statements_and_expressions`.
+
+Differences Between Cython and C
+================================
+
+Scope Rules
+===========
+
+Built-in Constants
+==================
+
+Operator Precedence
+===================
+
+For-loops
+==========
+
+=====================
+Functions and Methods
+=====================
+
+This section was moved to :ref:`python_functions_vs_c_functions`.
+
+
+Callable from Python (def)
+==========================
+
+Callable from C (cdef)
+======================
+
+Callable from both Python and C (cpdef)
+=======================================
+
+Overriding
+==========
+
+This section was moved to :ref:`overriding_in_extension_types`.
+
+Function Pointers
+=================
+
+Python Built-ins
+================
+
+This section was moved to :ref:`built_in_functions`.
+
+Optional Arguments
+==================
+
+This section was moved to :ref:`optional_arguments`.
+
+Keyword-only Arguments
+=======================
+
+This section was moved to :ref:`keyword_only_argument`.
+
+============================
+Error and Exception Handling
+============================
+
+This section was moved to :ref:`error_return_values`.
+
+Checking return values for non-Cython functions..
+=================================================
+
+This section was moved to :ref:`checking_return_values_of_non_cython_functions`.
+
+=======================
+Conditional Compilation
+=======================
+
+This section was moved to :ref:`conditional_compilation`.
+
+Compile-Time Definitions
+=========================
+
+Conditional Statements
+=======================