HttpSliceModule - Revision history

Zhuzhaoyuan: /* Acknowledgments */

2012-11-30T07:53:57Z

‎Acknowledgments

Zhuzhaoyuan: /* Other builds */

2012-11-30T07:50:09Z

‎Other builds

Zhuzhaoyuan: /* Other builds */

2012-11-30T07:49:46Z

‎Other builds

Zhuzhaoyuan: /* Other tengine modules on Github */

2012-11-30T06:59:00Z

‎Other tengine modules on Github

Zhuzhaoyuan: /* Other tengine modules on Github */

2012-11-30T06:58:40Z

‎Other tengine modules on Github

Zhuzhaoyuan: /* Other tengine modules on Github */

2012-11-30T06:57:09Z

‎Other tengine modules on Github

Zhuzhaoyuan: /* Tagging releases */

2012-11-30T06:54:58Z

‎Tagging releases

Zhuzhaoyuan: /* Installation */

2012-11-30T06:54:09Z

‎Installation

Zhuzhaoyuan: /* Examples */

2012-11-30T06:51:48Z

‎Examples

Zhuzhaoyuan: /* Examples */

2012-11-30T06:50:26Z

‎Examples

@@ Line 187: / Line 187: @@
 = Acknowledgments =
-Thanks to [Joshua Zhu](http://blog.zhuzhaoyuan.com) and the Taobao
+Thanks to [http://blog.zhuzhaoyuan.com Joshua Zhu] and the Taobao platform engineering team for releasing ''tengine''. Also for being kind
-platform engineering team for releasing ''tengine''. Also for being kind
+enough to clarify things regarding this module on the [http://code.taobao.org/mailman/listinfo/tengine Tengine mailing list].
 enough to clarify things regarding this module on the
-[Tengine mailing list](http://code.taobao.org/mailman/listinfo/tengine).
 = License =

@@ Line 183: / Line 183: @@
 * As referred at the outset this module is part of the [http://tengine.taobao.org ''Tengine''] Nginx distribution. So you might want to save yourself some work and just build it from scratch using ''tengine'' in lieu if the official Nginx source.
-* If you fancy a bleeding edge Nginx package (from the dev releases) for Debian made to measure then you might be interested in my [http://debian.perusio.net/unstable debian] Nginx package. Instructions for using the repository and making the package live happily inside a stable distribution installation are [provided](http://debian.perusio.net).
+* If you fancy a bleeding edge Nginx package (from the dev releases) for Debian made to measure then you might be interested in my [http://debian.perusio.net/unstable debian] Nginx package. Instructions for using the repository and making the package live happily inside a stable distribution installation are [http://debian.perusio.net provided].
 = Acknowledgments =

@@ Line 181: / Line 181: @@
 = Other builds =
-. As referred at the outset this module is part of the
+* As referred at the outset this module is part of the [http://tengine.taobao.org ''Tengine''] Nginx distribution. So you might want to save yourself some work and just build it from scratch using ''tengine'' in lieu if the official Nginx source.
-    [''tengine''](http://tengine.taobao.org) Nginx distribution. So you
-    might want to save yourself some work and just build it from
+* If you fancy a bleeding edge Nginx package (from the dev releases) for Debian made to measure then you might be interested in my [http://debian.perusio.net/unstable debian] Nginx package. Instructions for using the repository and making the package live happily inside a stable distribution installation are [provided](http://debian.perusio.net).
-    scratch using ''tengine'' in lieu if the official Nginx source.
 = Acknowledgments =

@@ Line 176: / Line 176: @@
 Allows to concatenate a given set of files and ship a single response from the server. It's particularly useful for '''aggregating''' CSS and Javascript files.
-* [footer filter](https://github.com/taobao/nginx-http-footer-filter):
+* [https://github.com/taobao/nginx-http-footer-filter footer filter]:
 Allows to add some extra data (markup or not) at the end of a request body. It's pratical for things like adding time stamps or other miscellaneous stuff without having to tweak your application.

@@ Line 174: / Line 174: @@
 * [https://github.com/taobao/nginx-http-concat http concat]:
-   allows to concatenate a given set of files and ship a single response from the server. It's particularly useful for '''aggregating''' CSS and Javascript files.
+Allows to concatenate a given set of files and ship a single response from the server. It's particularly useful for '''aggregating''' CSS and Javascript files.
 * [footer filter](https://github.com/taobao/nginx-http-footer-filter):
-   allows to add some extra data (markup or not) at the end of a request body. It's pratical for things like adding time stamps or other miscellaneous stuff without having to tweak your application.
+Allows to add some extra data (markup or not) at the end of a request body. It's pratical for things like adding time stamps or other miscellaneous stuff without having to tweak your application.
 = Other builds =

@@ Line 169: / Line 169: @@
 = Tagging releases  =
-I'm tagging each release in synch with the
+I'm tagging each release in synch with the [http://tengine.taobao.org Tengine] releases.
-[Tengine](http://tengine.taobao.org) releases.
-−
 = Other tengine modules on Github =

@@ Line 151: / Line 151: @@
 = Installation =
-. Clone the git repo.
+* Clone the git repo.
+    git clone git://github.com/taobao/nginx-http-slice.git
-        git clone git://github.com/taobao/nginx-http-slice.git
-. Add the module to the build configuration by adding
+* Add the module to the build configuration by adding
      ''--add-module=/path/to/nginx-http-slice''.
+* Build the nginx binary.
-. Build the nginx binary.
-. Install the nginx binary.
+* Install the nginx binary.
-. Configure contexts where concat is enabled.
+* Configure contexts where concat is enabled.
-. Build your links such that the above format, i.e., all URIs that
+* Build your links such that the above format, i.e., all URIs that correspond to specific ranges. As example here's how to link to the first 4k of a file.
-    correspond to specific ranges. As example here's how to link to
+     <a href="http://example.com/datadumps/dump0.sql?start=0&end=4096" />db dump</a>
-    the first 4k of a file.
+* Done.
-        <a href="http://example.com/datadumps/dump0.sql?start=0&end=4096" />db dump</a>
-−
-. Done.
 = Tagging releases  =

@@ Line 101: / Line 101: @@
 '''Serve a huge DB file while sending headers except on the first slice'''
 <geshi lang="nginx">
-    location ^~ /dbdumps/ {
+location ^~ /dbdumps/ {
-        slice; # enable slicing
+    slice; # enable slicing
-        slice_start_arg first;
+    slice_start_arg first;
-        slice_end_arg last;
+    slice_end_arg last;
-        slice_header '-- '''db-slice-start'''';
+    slice_header '-- '''db-slice-start'''';
-        slice_header_first off;
+    slice_header_first off;
-−
+}
 </geshi>
@@ Line 117: / Line 117: @@
 '''Serve a huge DB file while sending headers except on the first slice'''
 <geshi lang="nginx">
-    location ^~ /dbdumps/ {
+location ^~ /dbdumps/ {
-        slice; # enable slicing
+    slice; # enable slicing
-        slice_start_arg first;
+    slice_start_arg first;
-        slice_end_arg last;
+    slice_end_arg last;
-        slice_header '-- '''db-slice-start'''';
+    slice_header '-- '''db-slice-start'''';
-        slice_header_first off;
+    slice_header_first off;
-        slice_footer '-- '''db-slice-end'''';
+    slice_footer '-- '''db-slice-end'''';
-−
+}
 </geshi>
 This differs from the previous in the sense that it sends a footer.
@@ Line 130: / Line 130: @@
 '''Serve a huge DB file while sending headers except on the first slice and send footer except on the last slice'''
 <geshi lang="nginx">
-    location ^~ /dbdumps/ {
+location ^~ /dbdumps/ {
-        slice; # enable slicing
+    slice; # enable slicing
-        slice_start_arg first;
+    slice_start_arg first;
-        slice_end_arg last;
+    slice_end_arg last;
-        slice_header '-- '''db-slice-start'''';
+    slice_header '-- '''db-slice-start'''';
-        slice_header_first off;
+    slice_header_first off;
-        slice_footer '-- '''db-slice-end'''';
+    slice_footer '-- '''db-slice-end'''';
-        slice_footer_last off;
+    slice_footer_last off;
-−
+}
 </geshi>
 Then a request like this:

@@ Line 97: / Line 97: @@
 = Examples =
-Here's some examples that explore all the options.
+Here're some examples that explore all the options.
 '''Serve a huge DB file while sending headers except on the first slice'''
@@ Line 112: / Line 112: @@
 Then a request like this:
      http://example.com/dbdumps/somedb.sql?first=0&last=1048576
 Send the first 1M and skip the ''-- '''db-slice-start''''' header.
-== Serve a huge DB file while sending headers except on the first slice ==
+'''Serve a huge DB file while sending headers except on the first slice'''
 <geshi lang="nginx">
      location ^~ /dbdumps/ {
@@ Line 129: / Line 128: @@
 This differs from the previous in the sense that it sends a footer.
-== Serve a huge DB file while sending headers except on the first slice and send footer except on the last slice ==
+'''Serve a huge DB file while sending headers except on the first slice and send footer except on the last slice'''
 <geshi lang="nginx">
      location ^~ /dbdumps/ {
@@ Line 143: / Line 142: @@
 Then a request like this:
      http://example.com/dbdumps/somedb.sql?first=0&last=1048576
 Send the first 1M and skip the ''-- '''db-slice-start''''' header.