Skip to content

Commit

Permalink
build: Remove .. include:: ../../../links/links.rst from tutorial docs
Browse files Browse the repository at this point in the history
  • Loading branch information
sarina committed Nov 1, 2023
1 parent 7689c48 commit 4e7d928
Show file tree
Hide file tree
Showing 29 changed files with 12 additions and 69 deletions.
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/anatomy/html.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,5 +25,3 @@ Note the following details about the HTML file.

* The values ``self.upvotes`` and ``self.downvotes`` reference the fields in
the XBlock Python class.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/anatomy/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,5 +20,3 @@ example Thumbs XBlocK, see :ref:`Customize Your XBlock`.
html
javascript
stylesheets

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/anatomy/javascript.rst
Original file line number Diff line number Diff line change
Expand Up @@ -44,5 +44,3 @@ Note the following details about the JavaScript file.

The XBlock JavaScript code can also use the ``children`` and ``childMap``
functions as needed. For more information, see :ref:`XBlock Children`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/anatomy/python.rst
Original file line number Diff line number Diff line change
Expand Up @@ -92,5 +92,3 @@ Note the following details about the vote handler.
* The updated ``upvotes`` and ``downvotes`` fields are returned.

For more information, see :ref:`Handler Methods`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/anatomy/stylesheets.rst
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,3 @@ application.

The styles in ``thumbs.css`` are referenced in the :ref:`XBlock HTML file <The
XBlock HTML File>`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/concepts/children.rst
Original file line number Diff line number Diff line change
Expand Up @@ -70,5 +70,3 @@ following methods.
element that has a specific name.

.. examples?
.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/concepts/events.rst
Original file line number Diff line number Diff line change
Expand Up @@ -102,5 +102,3 @@ have a ``has_score`` variable set to ``True``.
.. code-block:: python
has_score = True
.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/concepts/fields.rst
Original file line number Diff line number Diff line change
Expand Up @@ -271,5 +271,3 @@ Default Fields in a New XBlock
When you create a new XBlock, the ``count`` field is added to the Python file
by default. This field is for demonstration purposes and you should replace it
with your own field definitions.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/concepts/fragments.rst
Original file line number Diff line number Diff line change
Expand Up @@ -100,5 +100,3 @@ CSS strings generated from the XBlock's static files.
********************
TBP

.. include:: ../../../links/links.rst
4 changes: 2 additions & 2 deletions docs/xblock-tutorial/concepts/index.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _XBlock Concepts:

####################
###############
XBlock Concepts
####################
###############

You build XBlocks that course teams use to create independent course components
that work seamlessly with other components in an online course. For example,
Expand Down
7 changes: 2 additions & 5 deletions docs/xblock-tutorial/concepts/methods.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _XBlock Methods:

####################
##############
XBlock Methods
####################
##############

You use XBlock methods in the XBlock Python file to define the behavior of your
XBlock.
Expand Down Expand Up @@ -111,6 +111,3 @@ When you create a new XBlock, two methods are added automatically.
* The handler method ``increment_count``.

This method is for demonstration purposes and you can remove it.


.. include:: ../../../links/links.rst
5 changes: 2 additions & 3 deletions docs/xblock-tutorial/concepts/runtimes.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _XBlock Runtimes:

####################
###############
XBlock Runtimes
####################
###############

An XBlock runtime is the application that hosts XBlock. For example, the XBlock
SDK, the :ref:`edX LMS <EdX Learning Management System as an XBlock Runtime>`,
Expand Down Expand Up @@ -182,4 +182,3 @@ For more information, see `XBlock Runtime API`_ in the *XBlock API Guide*.
.. _XBlock Runtime API: http://edx.readthedocs.io/projects/xblock/en/latest/
.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/customize/custom-html.rst
Original file line number Diff line number Diff line change
Expand Up @@ -72,5 +72,3 @@ Next Step

After you complete your customizations to the HTML file, you continue on and
:ref:`customize the XBlock JavaScript file<Customize myxblock.js>`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/customize/custom-javascript.rst
Original file line number Diff line number Diff line change
Expand Up @@ -75,5 +75,3 @@ Next Step

After you complete your customizations to the JavaScript file, you continue on
and :ref:`customize the XBlock CSS file<Customize myxblock.css>`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/customize/custom-python.rst
Original file line number Diff line number Diff line change
Expand Up @@ -168,5 +168,3 @@ Next Step

After you complete your customizations to the Python file, you continue on and
:ref:`customize the XBlock HTML file<Customize myxblock.html>`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/customize/custom-stylesheets.rst
Original file line number Diff line number Diff line change
Expand Up @@ -62,5 +62,3 @@ matches the code in the Thumbs XBlock.

The styles in ``thumbs.css`` are referenced in the :ref:`XBlock HTML file <The
XBlock HTML File>`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/customize/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,5 +21,3 @@ For more information about the different components of an XBlock, see
custom-html
custom-javascript
custom-stylesheets

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/edx_platform/devstack.rst
Original file line number Diff line number Diff line change
Expand Up @@ -120,5 +120,3 @@ You can then edit the properties of the instance as needed by selecting the
For more information about working with components in Studio, see
:ref:`opencoursestaff:Developing Course Components` in the *Building and
Running an Open edX* guide.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/edx_platform/edx.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,5 +35,3 @@ After you submit the pull request, edX will review your XBlock to ensure that
it is appropriate for use on edx.org. Specifically, edX will review your XBlock
for security, scalability, accessibility, and fitness of purpose. You should be
prepared to respond to questions and comments from edX in your pull request.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/edx_platform/edx_lms.rst
Original file line number Diff line number Diff line change
Expand Up @@ -172,5 +172,3 @@ in order to observe the translated strings for your chosen locale.
internationalization support. There is no guarantee your strings will be
matched by the LMS, and even if matches are found, the translations may be
incorrect in the context of your specific XBlock.

.. include:: ../../../links/links.rst
3 changes: 0 additions & 3 deletions docs/xblock-tutorial/edx_platform/edx_studio.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,3 @@ Studio requires XBlocks to have the following properties.
* A class property named ``non_editable_metadata_fields``. This variable
contains a list of the XBlock fields that should not be displayed in the
Studio editor.


.. include:: ../../../links/links.rst
4 changes: 2 additions & 2 deletions docs/xblock-tutorial/front_matter/index.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _Front Matter:

#############################
###################
General Information
#############################
###################

.. toctree::
:maxdepth: 2
Expand Down
3 changes: 0 additions & 3 deletions docs/xblock-tutorial/front_matter/read_me.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,3 @@ https://github.com/openedx/edx-documentation/tree/master/en_us/xblock-tutorial/s
The edX documentation team welcomes contributions from Open edX community
members. You can find guidelines for how to `contribute to edX Documentation`_
in the GitHub edx/edx-documentation repository.

.. include:: ../../../links/links.rst

2 changes: 0 additions & 2 deletions docs/xblock-tutorial/getting_started/create_first_xblock.rst
Original file line number Diff line number Diff line change
Expand Up @@ -29,5 +29,3 @@ the next sections, you will learn :ref:`how to use the XBlock SDK <Using the
XBlock Software Development Kit>`, about the :ref:`anatomy of an XBlock
<Anatomy of an XBlock>`, and :ref:`how to customize your new XBlock <Customize
Your XBlock>`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/getting_started/prereqs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -53,5 +53,3 @@ instructions.

For information on creating the virtual environment for your XBlock, see
:ref:`Create and Activate the Virtual Environment`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/getting_started/setup_sdk.rst
Original file line number Diff line number Diff line change
Expand Up @@ -69,5 +69,3 @@ Then create the virtual environment in your ``xblock_development`` directory.
.. include:: ../reusable/clone_sdk.rst

When the requirements are installed, you are in the ``xblock_development`` directory, which contains the ``venv`` and ``xblock-sdk`` subdirectories. You can now :ref:`create your first XBlock <Create Your First XBlock>`.

.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/overview/examples.rst
Original file line number Diff line number Diff line change
Expand Up @@ -82,5 +82,3 @@ You can explore the other example XBlocks in the XBlock SDK.
* `Slider XBlock`_
* Several `Content XBlocks`_
* Several `Structure XBlocks`_

.. include:: ../../../links/links.rst
11 changes: 4 additions & 7 deletions docs/xblock-tutorial/overview/introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -91,9 +91,9 @@ you should have basic knowledge of the following technologies.
* Python virtualenv
* Git

===================
================
XBlock Resources
===================
================

This tutorial is meant to guide developers through the process of creating an
XBlock, and to explain the :ref:`concepts<XBlock Concepts>` and
Expand All @@ -102,9 +102,9 @@ XBlock, and to explain the :ref:`concepts<XBlock Concepts>` and
EdX provides the `XBlock SDK`_ to support the creation of new XBlocks.
Developers should also see the :ref:`xblockapi:EdX XBlock API Guide`.

=========================================
========================================
XBlock Independence and Interoperability
=========================================
========================================

You must design your XBlock to meet two criteria.

Expand All @@ -113,6 +113,3 @@ You must design your XBlock to meet two criteria.

* The XBlock must work together with other XBlocks. Course teams must be able
to combine different XBlocks in flexible ways.


.. include:: ../../../links/links.rst
2 changes: 0 additions & 2 deletions docs/xblock-tutorial/sdk/get_started_sdk.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,5 +17,3 @@ This section describes how to get started with the XBlock SDK.
.. include:: ../reusable/create_db.rst

.. include:: ../reusable/run_server.rst

.. include:: ../../../links/links.rst

0 comments on commit 4e7d928

Please sign in to comment.